SEO-MCP-PRO

MCP安全风控

提供方 bypixels · 包名 sandi-ads

安全风控 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

sandi-ads is an MCP server designed for Claude, providing 121 tools for website operations, Google Marketing, SEO, performance analysis, security auditing, monitoring, accessibility testing, and more, enabling natural-language website management and optimization.

一句话选型结论

按资料字段整理

SEO-MCP-PRO 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment MCP Server Claude Integration TypeScript Website Operations Google Marketing SEO Analysis Performance Monitoring Security Auditing Accessibility Testing

支持客户端

适用场景

Local DeploymentMCP ServerClaude Integration

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx -y sandi-ads

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 node,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
SEO-MCP-PRO当前 未标注 stdio · 本地进程 本地部署 有 2026-10-02
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bypixels上游标注的维护方 bypixels
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时sandi-ads · node本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-10-02上游最后核验时间

详细介绍

13.4 KB
来自项目仓库与上游目录的原文,未做删改

Sandi Ads

A Model Context Protocol (MCP) server that provides Claude with 121 tools for website operations, Google Marketing, SEO, performance analysis, security auditing, monitoring, accessibility testing, and more.


Table of Contents

  • Overview
  • Free vs Pro
  • Quick Start
  • Tool Modules
  • Configuration
  • Claude Desktop Integration
  • Web Dashboard (Pro)
  • Dashboard REST API
  • Architecture
  • Commands
  • OAuth Token Helper
  • License

Overview

sandi-ads is a comprehensive MCP server built with TypeScript in strict mode. It connects Claude to the full spectrum of website management tasks -- from Google Analytics reporting and Tag Manager configuration to SSL analysis, Core Web Vitals monitoring, and WCAG accessibility audits.

  • 121 tools across 17 modules
  • Zero external runtime frameworks -- uses node:http for the optional dashboard
  • Built-in credential management with AES-256-GCM encryption (Pro)
  • Per-service rate limiting and in-memory caching

Free vs Pro

Sandi Ads follows a hybrid open source model. The core MCP tools are free and open source. Advanced reporting, the web dashboard, and credential management require a Pro license.

Feature Free Pro
Google Analytics 4 (GA4) tools Yes Yes
Google Tag Manager (GTM) tools Yes Yes
Google Search Console (GSC) tools Yes Yes
Google Ads tools Yes Yes
Google Business Profile tools Yes Yes
Indexing API tools Yes Yes
PageSpeed Insights / Lighthouse Yes Yes
Core Web Vitals / CrUX Yes Yes
Security auditing (SSL, headers, Safe Browsing) Yes Yes
SEO technical (robots, sitemaps, canonicals, etc.) Yes Yes
Monitoring (uptime, DNS, certificates) Yes Yes
Accessibility (WCAG, contrast, images) Yes Yes
Cloudflare integration Yes Yes
Utilities (tech detection, broken links, WHOIS) Yes Yes
Dashboard overview tool Yes Yes
Site Health Report (report_site_health) -- Yes
SEO Audit Report (report_seo_audit) -- Yes
Executive Summary (report_executive_summary) -- Yes
Web Dashboard (browser UI on port 3737) -- Yes
Encrypted Credential Store (AES-256-GCM) -- Yes
SSE Real-time Monitoring -- Yes

Activating Pro

Set your license key as an environment variable:```bash
SANDI_ADS_KEY=SMCP-XXXX-XXXX-XXXX-XXXX


Or add it to your `.env` file. The server logs the active tier on startup.

---

## Quick Start

### Install from npm```bash
# Run directly with npx (no install needed)
npx sandi-ads

# Or install globally
npm install -g sandi-ads
sandi-ads

Install from source```bash

git clone https://github.com/bypixels/sandi-ads.git
cd sandi-ads
pnpm install
pnpm build
pnpm start


### Development```bash
pnpm dev         # Development mode with hot reload

Tool Modules

The server organizes its tools into 17 modules spanning 14 core categories:

Module Description Example Tools
Google Tag Manager Accounts, containers, workspaces, tags, triggers, variables, versions gtm_list_containers, gtm_create_tag, gtm_publish_version
Google Analytics 4 Accounts, properties, reports, realtime, funnels, custom dimensions/metrics, audiences, data streams, conversion events ga4_run_report, ga4_run_realtime_report, ga4_run_funnel_report
Google Search Console Sites, performance queries, top queries/pages, sitemaps, URL inspection, coverage gsc_query_performance, gsc_top_queries, gsc_inspect_url
Google Ads Customers, campaigns, ad groups, keywords, budgets, performance, search terms, keyword ideas ads_list_campaigns, ads_create_campaign, ads_get_keyword_ideas
Google Business Profile Accounts, locations, reviews, posts, insights, media gbp_list_locations, gbp_reply_review, gbp_create_post
Indexing API Submit URLs for indexing, check status, batch operations indexing_publish, indexing_get_status, indexing_batch_publish
PageSpeed Insights Page performance analysis via PSI API psi_analyze
CrUX Chrome UX Report data queries and historical trends crux_query, crux_history
Core Web Vitals LCP, INP, CLS aggregate reports cwv_report
Lighthouse Full Lighthouse audits via PSI API lighthouse_audit
Security SSL analysis, security headers, Safe Browsing, comprehensive audits security_ssl_analyze, security_headers_check, security_audit
SEO Technical Robots.txt, sitemaps, canonicals, redirects, structured data, headings, meta tags seo_robots_analyze, seo_sitemap_analyze, seo_structured_data
Monitoring Uptime, response time, DNS lookup/propagation, certificate checks monitor_check_uptime, monitor_dns_lookup, monitor_certificate
Accessibility WCAG audits, contrast checking, image alt text validation a11y_audit, a11y_check_contrast, a11y_check_images
Utilities Tech stack detection, broken link scanning, WHOIS, headers, screenshots util_tech_detection, util_broken_links, util_whois_lookup
Cloudflare Zones, DNS records, analytics, cache purge, firewall events cf_get_zones, cf_create_dns_record, cf_purge_cache
Reports Aggregated site health, SEO audit, executive summary report_site_health, report_seo_audit, report_executive_summary

Configuration

All configuration is handled through environment variables. Create a .env file in the project root:

Sandi Ads License

Variable Description
SANDI_ADS_KEY Pro license key (SMCP-XXXX-XXXX-XXXX-XXXX) (the old SEO_MCP_PRO_KEY still works as a fallback)

Google OAuth 2.0

Variable Description
GOOGLE_CLIENT_ID OAuth 2.0 client ID
GOOGLE_CLIENT_SECRET OAuth 2.0 client secret
GOOGLE_REDIRECT_URI OAuth redirect URI
GOOGLE_REFRESH_TOKEN OAuth refresh token

Google Service Account

Variable Description
GOOGLE_SERVICE_ACCOUNT_KEY_FILE Path to service account JSON key file
GOOGLE_SERVICE_ACCOUNT_IMPERSONATE Email address for domain-wide delegation

API Keys

Variable Description
GOOGLE_PAGESPEED_API_KEY PageSpeed Insights API key
GOOGLE_SAFE_BROWSING_API_KEY Safe Browsing API key

Google Ads

Variable Description
GOOGLE_ADS_DEVELOPER_TOKEN Google Ads API developer token
GOOGLE_ADS_LOGIN_CUSTOMER_ID Manager account customer ID

Cloudflare

Variable Description
CLOUDFLARE_API_TOKEN Cloudflare API token (preferred)
CLOUDFLARE_EMAIL Cloudflare account email (legacy auth)
CLOUDFLARE_API_KEY Cloudflare global API key (legacy auth)

Dashboard (Pro)

Variable Description Default
DASHBOARD_ENABLED Enable the web dashboard false
DASHBOARD_PORT Dashboard HTTP port 3737
DASHBOARD_API_KEY API key for dashboard access --
DASHBOARD_AUTH_REQUIRED Require authentication for dashboard false

Claude Desktop Integration

Add the server to your claude_desktop_config.json:```json
{
"mcpServers": {
"sandi-ads": {
"command": "npx",
"args": ["-y", "sandi-ads"],
"env": {
"GOOGLE_PAGESPEED_API_KEY": "your-api-key",
"SANDI_ADS_KEY": "SMCP-XXXX-XXXX-XXXX-XXXX"
}
}
}
}


Or if installed from source:```json
{
  "mcpServers": {
    "sandi-ads": {
      "command": "node",
      "args": ["/path/to/sandi-ads/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_PAGESPEED_API_KEY": "your-api-key"
      }
    }
  }
}

Once configured, Claude will have access to all available tools. Ask Claude to analyze your website's performance, check SEO issues, audit security headers, or manage your Google Marketing stack -- all through natural language.


Web Dashboard (Pro)

The server includes an optional self-contained web dashboard for browser-based access to all tools and reports. Requires a Pro license.```bash
SANDI_ADS_KEY=SMCP-... pnpm dashboard


Or set `DASHBOARD_ENABLED=true` and `SANDI_ADS_KEY` in your `.env` file and run `pnpm start`.

The dashboard is available at `http://localhost:3737` and provides:

- **Tool browser** -- Browse and execute all available tools
- **Site reports** -- Site health, SEO audit, and executive summary reports
- **Real-time monitoring** -- Server-Sent Events for live status updates
- **Credential management** -- Save and manage API keys through the UI (AES-256-GCM encrypted at rest)
- **Status overview** -- Authentication state, cache statistics, rate limit status

---

## Dashboard REST API

When the dashboard is enabled (Pro), the following HTTP endpoints are available:

### Health and Status

| Method | Endpoint | Description |
|---|---|---|
| `GET` | `/api/health` | Server health check |
| `GET` | `/api/status/auth` | Authentication status |
| `GET` | `/api/status/cache` | Cache statistics |
| `GET` | `/api/status/rate-limits` | Rate limit status per service |

### Tools and Reports

| Method | Endpoint | Description |
|---|---|---|
| `GET` | `/api/tools` | List all available tools |
| `POST` | `/api/tool/:name` | Execute a tool (JSON body = tool input) |
| `GET` | `/api/dashboard?url=X` | Dashboard overview for a URL |
| `GET` | `/api/report/site-health?url=X` | Site health report |
| `GET` | `/api/report/seo-audit?url=X` | SEO audit report |

### Settings and Credentials

| Method | Endpoint | Description |
|---|---|---|
| `GET` | `/api/settings/schema` | Configuration schema |
| `GET` | `/api/settings/credentials` | Retrieve saved credentials |
| `POST` | `/api/settings/credentials` | Save credentials |
| `POST` | `/api/settings/credentials/validate` | Validate credentials |

### Monitoring

| Method | Endpoint | Description |
|---|---|---|
| `GET` | `/api/sse?url=X` | Server-Sent Events stream for real-time monitoring |

---

## Architecture```
src/
├── index.ts                  # Entry point
├── server.ts                 # MCP server setup and tool registration
├── licensing/                # License management (free vs pro)
│   ├── index.ts              # Key validation, isPro(), getLicenseTier()
│   └── tiers.ts              # Pro tool and feature definitions
├── auth/                     # Authentication layer
│   ├── oauth.ts              # Google OAuth 2.0 flow
│   ├── service-account.ts    # Service account authentication
│   └── token-manager.ts      # Automatic token refresh
├── tools/                    # 14 tool modules
│   ├── google/               # GTM, GA4, GSC, Ads, Business Profile, PageSpeed, Indexing
│   ├── performance/          # Core Web Vitals, CrUX, Lighthouse
│   ├── security/             # SSL, headers, Safe Browsing
│   ├── seo-technical/        # Structured data, robots, sitemaps, canonicals
│   ├── accessibility/        # WCAG audits, contrast checking
│   ├── monitoring/           # Uptime, DNS, certificates
│   ├── integrations/         # Cloudflare
│   ├── utilities/            # Screenshots, tech detection, broken links
│   └── reports/              # Site health, SEO audit, executive summary
├── dashboard/                # Optional HTTP dashboard (Pro)
│   ├── http-server.ts        # node:http server (zero frameworks)
│   ├── routes/               # API, SSE, and settings route handlers
│   ├── services/             # Credential store (AES-256-GCM), data orchestration
│   └── ui/                   # Self-contained HTML dashboard
├── utils/                    # Shared utilities
│   ├── rate-limiter.ts       # Per-service rate limiting (bottleneck)
│   ├── cache.ts              # In-memory + file cache
│   └── logger.ts             # Structured JSON logging (winston)
├── config/                   # Google API scopes, default values
└── types/                    # TypeScript type definitions

Design Principles

  • Zod validation on all tool inputs and outputs
  • Per-service rate limiting via bottleneck (e.g., GTM: 50 req/min, GA4: 100 req/min, GSC: 1200 req/day)
  • In-memory caching with 5-minute TTL (1000-item limit) and file cache fallback (1-hour TTL)
  • Structured logging with Winston in JSON format
  • Automatic token refresh for all Google API interactions
  • stdio transport for Claude Desktop; optional HTTP transport for the dashboard

Commands

Command Description
pnpm install Install dependencies
pnpm build Build with tsup (ESM)
pnpm start Run the MCP server (stdio transport)
pnpm dashboard Run with web dashboard enabled (Pro)
pnpm dev Development mode with hot reload
pnpm test Run tests with vitest
pnpm lint Lint with ESLint
pnpm typecheck TypeScript type checking

OAuth Token Helper

To obtain a Google OAuth refresh token for local development:bash node get-token.cjs

This interactive script reads GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from your .env file, opens a browser for the OAuth consent flow, and writes the resulting refresh token back to .env.


License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
SEO-MCP-PRO 怎么安装?

在客户端按下面的安装命令接入:npx -y sandi-ads。对应的包名是 sandi-ads。装完在客户端配置里引用同一个包或端点。

SEO-MCP-PRO 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

SEO-MCP-PRO 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

SEO-MCP-PRO 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

SEO-MCP-PRO 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

SEO-MCP-PRO 能提供哪些能力?

资料显示能力标签包括 Local Deployment、MCP Server、Claude Integration、TypeScript、Website Operations、Google Marketing。具体工具清单以官方文档为准。

SEO-MCP-PRO 需要什么运行环境?

运行时为 node;属于本地进程,需要在本机装好运行环境。

SEO-MCP-PRO 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-10-02。