使用说明
SEOctopus
你的AI的SEO大脑。23个工具。一台MCP服务器。
停止谷歌搜索SEO指标。让你的AI直接拉它们。
排名跟踪、谷歌分析、网站审计、关键字研究、竞争分析、核心网络生命体征和研究支持的评分系统——所有这些都可以通过自然语言或CLI访问。
为什么存在
每个SEO工具每月花费100-300美元。Ahrefs、SEMrush、Moz——它们很棒，但它们是为人类点击仪表板而设计的。
SEOctopus是不同的。 它专为人工智能而设计。您的Claude助手可以通过MCP实时提取排名、分析和审计数据——无需浏览器选项卡、无需复制粘贴、无需每月订阅。
你问一个问题。你的人工智能会用实时数据来回答。
You: "Where do we rank for 'best mcp servers' and how's our traffic this month?"
Claude: Let me check... [calls rank_check + analytics_overview]
Rankings:
- "best mcp servers" → #7 (up from #12 last week)
- "mcp server tools" → #3
Traffic (last 28 days):
- Sessions: 4,231 (+18% vs previous period)
- Top source: Organic Search (62%)
- Bounce rate: 34% (good)
如果你只尝试三件事，试试这些
| 工具 | 它做什么 | 为什么它很棒 |
|---|---|---|
rank_check |
任何关键词的实时谷歌排名 | 不需要API密钥-使用隐形Playwright抓取和反检测 |
analytics_overview |
一次通话中的完整GA4仪表板 | 会话、用户、跳出率、首页、流量来源——带时段比较 |
octo_score |
0-100 SEO评分按实际谷歌排名因素加权 | 研究支持的权重、字母等级、可操作的建议 |
8种武器（23种工具）
手臂1：排名追踪
不需要API密钥。使用具有反检测功能的隐形浏览器自动化。
| 工具 | 你得到什么 |
|---|---|
rank_check |
您的域名在特定关键字中的排名（扫描前100） |
rank_history |
趋势分析：随时间变化的上升、下降或稳定（存储在SQLite本地） |
rank_competitors |
谁的排名比你高，为什么 |
rank_serp_features |
特色片段、People Ask、知识面板、图片包 |
第二部分：谷歌分析（GA4）
需要OAuth2设置（一次性，5分钟）。
| 工具 | 你得到什么 |
|---|---|
analytics_overview |
会话、用户、跳出率、首页、流量来源——带比较期 |
analytics_pages |
按页面浏览量、参与度或转化率排序的每页性能 |
analytics_traffic |
按来源、媒介、活动或渠道划分的流量细分 |
analytics_realtime |
当前数据：活跃用户、当前页面、实时事件 |
第三部分：SEO审计
只需传递一个URL。无需设置。
| 工具 | 你得到什么 |
|---|---|
audit_page |
全页面审核：标题、元、标题、图像、规范、OG标签——带评分 |
audit_site |
BFS抓取您的整个网站，并进行问题聚合（尊重robots.txt） |
audit_structured_data |
JSON-LD验证，包括必需/推荐的字段检查 |
audit_content |
字数、Flesch可读性、关键字密度、标题层次结构 |
audit_links |
内部/外部链接分析+并发检查的断链检测 |
第四部分：关键词研究
搜索控制台工具需要OAuth2。建议没有它也能起作用。
| 工具 | 你得到什么 |
|---|---|
keywords_search_console |
您的实际关键字表现：点击次数、展示次数、点击率、平均位置 |
keywords_suggestions |
谷歌自动补全+人们还要求从种子关键字扩展 |
keywords_gaps |
速赢：你印象深刻但位置不佳的关键词（位置4-20） |
keywords_cluster |
按主题对关键字进行分组并推断搜索意图（信息/事务/导航） |
第五部分：竞争分析
使用Playwright进行SERP抓取+Cheerio进行页面分析。
| 工具 | 你得到什么 |
|---|---|
competitive_analyze |
并排比较：字数、标题、图像、结构化数据、加载时间 |
competitive_content_gap |
你的竞争对手涵盖的主题和标题是你没有涵盖的 |
competitive_serp_share |
您在关键字集中SERP房地产与竞争对手的份额 |
第6部分：性能和核心网络关键
| 工具 | 你得到什么 |
|---|---|
performance_audit |
Lighthouse评分：性能、SEO、可访问性、最佳实践 |
performance_compare |
在2-5个URL上运行Lighthouse并并排比较 |
performance_cwv |
LCP、INP、CLS的通过/失败评级与谷歌的阈值一致 |
手臂7:OctoScore
| 工具 | 你得到什么 |
|---|---|
octo_score |
加权0-100 SEO评分，包括字母等级（A-F）和优先推荐 |
第8组：报告
| 工具 | 你得到什么 |
|---|---|
octo_report |
JSON、Markdown或深色主题HTML的完整多模块报告 |
快速入门（2分钟）
# 1. Clone and install
git clone https://github.com/itsjwill/seoctopus.git
cd seoctopus
npm install
# 2. Build
npm run build
# 3. Install browser for rank tracking
npx playwright install chromium
添加到Claude作为MCP服务器
{
"mcpServers": {
"seoctopus": {
"command": "node",
"args": ["/path/to/seoctopus/dist/index.js"]
}
}
}
就是这样。克劳德现在有23个SEO工具。
还想要谷歌分析+搜索控制台吗？
# One-time OAuth2 setup (requires Google Cloud project)
npx seoctopus auth setup -c /path/to/credentials.json
Google Cloud Setup (click to expand)
- 首选 谷歌云控制台
- 创建新项目（或使用现有项目）
- 启用 谷歌分析数据API 和 搜索控制台API
- 创建 OAuth2凭据 → 桌面应用程序
- 下载凭据JSON文件
- 跑
npx seoctopus auth setup -c credentials.json
我应该从哪里开始？
只是想查看排名吗？
→ 无需设置。 rank_check 使用隐形浏览器抓取。
想要完整的SEO图片吗？ → 设置Google OAuth2（5分钟）以解锁分析+搜索控制台工具。
建立SEO监控系统？
→ Use octo_score + rank_history 用于自动每周跟踪和趋势检测。
与竞争对手相比？
→ competitive_analyze + competitive_content_gap 给你一个完整的画面。
需要客户报告吗？
→ octo_report 生成具有深色主题的演示就绪HTML。
OctoScore——SEO评分系统
不是另一个虚荣指标。OctoScore的权重取决于谷歌实际关心的事情：
| 因素 | 重量 | 它测量什么 | 为什么重要 |
|---|---|---|---|
| 内容质量 | 25% | 字数、可读性、深度 | 谷歌排名第一的信号 |
| 核心网络生命 | 15% | LCP、INP、CLS | 自2021年以来的直接排名因素 |
| 标题优化 | 12% | 长度、关键字位置 | 最高点击率影响元素 |
| 移动友好 | 10% | Viewport，响应式设计 | 60%以上的搜索是移动的 |
| 用户参与度 | 10% | 跳出率、页面停留时间 | 谷歌追踪的行为信号 |
| 反向链接 | 8% | 指向的外部链接 | 仍然是排名前三的因素 |
| 链接多样性 | 7% | 内部/外部链接组合 | 健康的网站链接平衡 |
| E-A-T | 5% | 作者、引用、信任 | 对YMYL内容至关重要 |
| 新鲜度 | 5% | 最后修改时间，发布日期 | 谷歌奖励最近更新的内容 |
| 专题权威 | 3% | 标题覆盖率、语义深度 | 综合内容排名更好 |
分数： A. (90+) · B (75-89) · C (60-74) · D (40-59) · F (<40)
每个分数都有按估计影响排名的优先建议。
CLI使用情况
SEOctopus也是一个独立的终端工具。
# Check where you rank
seoctopus rank check "best seo tools" "mcp server" -d example.com
# Full page audit
seoctopus audit page https://example.com
# Content analysis with keyword targeting
seoctopus audit content https://example.com -k "target keyword"
# Core Web Vitals check
seoctopus perf cwv https://example.com
# Keyword opportunities from Search Console
seoctopus keywords gaps -s https://example.com
# Generate HTML report
seoctopus report https://example.com -f html -o report.html
# Calculate OctoScore
seoctopus score https://example.com -k "target keyword"
# Competitor deep dive
seoctopus compete analyze "target keyword" -u https://yoursite.com
All CLI Commands (click to expand)
# Rank tracking
seoctopus rank check <keywords...> -d <domain> [-c country] [--device desktop|mobile]
seoctopus rank history -d <domain> [-k keywords...] [--days 30]
# SEO auditing
seoctopus audit page <url>
seoctopus audit site <url> [-p maxPages] [-d depth]
seoctopus audit content <url> [-k keyword]
seoctopus audit links <url> [-e checkExternal]
# Performance
seoctopus perf audit <url> [--device mobile|desktop]
seoctopus perf cwv <url> [-s mobile|desktop]
seoctopus perf compare <url1> <url2> [url3...] [--device mobile|desktop]
# Google Analytics
seoctopus analytics overview -p <propertyId> [--date last28days] [--compare previousPeriod]
seoctopus analytics pages -p <propertyId> [--sort pageviews|engagement|bounceRate|conversions]
seoctopus analytics realtime -p <propertyId>
# Keywords
seoctopus keywords gsc -s <siteUrl> [--sort clicks|impressions|ctr|position]
seoctopus keywords suggest <seed> [-c country]
seoctopus keywords gaps -s <siteUrl> [--min-impressions 100] [--max-position 20]
seoctopus keywords cluster <keyword1> <keyword2> [keyword3...]
# Competitive
seoctopus compete analyze <keyword> [-u yourUrl] [-n numCompetitors]
seoctopus compete gap <yourUrl> <competitorUrl1> [competitorUrl2...]
seoctopus compete share <keyword1> [keyword2...] -d <domain>
# Scoring & Reports
seoctopus score <url> [-k keyword] [-p ga4PropertyId]
seoctopus report <url> [-k keyword] [-f json|markdown|html] [-o outputFile]
# Auth & Config
seoctopus auth setup -c <credentialsFile>
seoctopus auth status
seoctopus config [--set key=value] [--get key]
它是如何建造的
seoctopus/
├── src/
│ ├── index.ts # MCP server entry (stdio transport)
│ ├── server.ts # 23 tool definitions with Zod schemas
│ ├── cli.ts # Full CLI with Commander
│ ├── auth/google.ts # OAuth2 with auto token refresh
│ ├── data/store.ts # SQLite (WAL mode) for history
│ ├── modules/
│ │ ├── rank-tracker/ # Playwright + anti-detection + SERP parsing
│ │ ├── analytics/ # GA4 Data API + Admin API + Realtime
│ │ ├── auditor/ # On-page, content, links, schema, crawler
│ │ ├── keywords/ # Search Console + autocomplete + clustering
│ │ ├── competitive/ # Competitor analysis + content gaps + SERP share
│ │ └── performance/ # Lighthouse + PageSpeed Insights + CWV
│ ├── scoring/ # OctoScore: weights, grader, recommendations
│ ├── reports/ # JSON, Markdown, HTML (dark theme) formatters
│ └── utils/ # Config (Conf), logging, rate limiter
├── bin/seoctopus.ts # CLI executable entry
├── tsup.config.ts # Dual-entry build (MCP + CLI)
└── package.json
在引擎盖下面
- 抗检测SERP刮擦 --随机用户代理、视口大小、类人延迟、通过Playwright进行的网络驱动程序欺骗
- 带WAL的SQLite --并行读/写用于排名历史跟踪和趋势检测
- OAuth2令牌管理 --自动刷新，凭证持久性，范围为只读
- 速率限制 -内置限制程序尊重Google API配额
- 延迟模块加载 --每个工具动态导入其模块，以实现快速启动
- 3种报告格式 --JSON用于机器，Markdown用于文档，HTML用于演示文稿的深色主题
技术栈
| 什么 | 为什么 |
|---|---|
| TypeScript（ES2022，严格） | 23个工具模式的类型安全 |
| MCP SDK | AI工具集成的标准协议 |
| 剧作家 | 用于排名跟踪的隐形浏览器 |
| googleapis | 官方GA4+搜索控制台客户端 |
| Lighthouse | 性能审计（与Chrome DevTools相同的引擎） |
| Cheerio | 用于审计的快速HTML解析 |
| better-splite3 | 嵌入式存储，零配置 |
| tsup | 快速构建，双入口点 |
比较：SEOctopus与替代品
| 功能 | SEOctopus | Ahrefs | SEMrush | Moz |
|---|---|---|---|---|
| 人工智能原生（MCP） | 是 | 否 | 否 | 不 |
| 价格 | 免费 | 99美元/月 | 130美元/月 | 99美元/日 |
| 排名追踪 | 是（隐形刮擦） | 是 | 是 | 有 |
| 谷歌分析 | 是（GA4 API） | 否 | 是 | 否 |
| 搜索资源平台 | 是（API） | 否 | 是 | 否 |
| 现场审计 | 是（爬虫） | 是 | 是 | 有 |
| 核心网页指标 | 是（灯塔） | 否 | 是 | 否 |
| 命令行界面 | 是 | 否 | 否 | 不 |
| 自托管 | 是 | 否 | 否 | 不 |
| 开源 | 是 | 否 | 否 | 不 |
SEOctopus不会取代Ahrefs的反向链接索引或SEMrush的关键字数据库。但对于AI工作流程中的实时SEO数据，这是唯一的选择。
发展
npm run dev # Watch mode (auto-rebuild on changes)
npm run typecheck # TypeScript strict mode check
npm run lint # ESLint
npm run format # Prettier
npm run test # Vitest
想用这样的人工智能工具构建真正的项目吗？
停止收集书签。开始发货。
加入 代理优势 --建筑商在这里学习如何将人工智能工具转化为收入。
贡献
发现bug还是有想法？打开一个问题。 用SEOctopus构建了一些很酷的东西？打开一个PR。
许可证
麻省理工学院——去建造一些东西。
