seoctopus (Itsjwill)

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)

______________________________________________________________________

如果你只尝试三件事，试试这些

______________________________________________________________________

8种武器（23种工具）

手臂1：排名追踪

*不需要API密钥。使用具有反检测功能的隐形浏览器自动化。*

第二部分：谷歌分析（GA4）

*需要OAuth2设置（一次性，5分钟）。*

第三部分：SEO审计

*只需传递一个URL。无需设置。*

第四部分：关键词研究

*搜索控制台工具需要OAuth2。建议没有它也能起作用。*

第五部分：竞争分析

*使用Playwright进行SERP抓取+Cheerio进行页面分析。*

第6部分：性能和核心网络关键

手臂7:OctoScore

第8组：报告

______________________________________________________________________

快速入门（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)

1. 首选 谷歌云控制台
2. 创建新项目（或使用现有项目）
3. 启用 谷歌分析数据API 和 搜索控制台API
4. 创建 OAuth2凭据 → 桌面应用程序
5. 下载凭据JSON文件
6. 跑 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的权重取决于谷歌实际关心的事情：

分数： A. (90+) · B (75-89) · C (60-74) · D (40-59) · F (\ All CLI Commands (click to expand)

# Rank tracking
seoctopus rank check  -d  [-c country] [--device desktop|mobile]
seoctopus rank history -d  [-k keywords...] [--days 30]

# SEO auditing
seoctopus audit page 
seoctopus audit site  [-p maxPages] [-d depth]
seoctopus audit content  [-k keyword]
seoctopus audit links  [-e checkExternal]

# Performance
seoctopus perf audit  [--device mobile|desktop]
seoctopus perf cwv  [-s mobile|desktop]
seoctopus perf compare   [url3...] [--device mobile|desktop]

# Google Analytics
seoctopus analytics overview -p 
 [--date last28days] [--compare previousPeriod]
seoctopus analytics pages -p 
 [--sort pageviews|engagement|bounceRate|conversions]
seoctopus analytics realtime -p 

# Keywords
seoctopus keywords gsc -s  [--sort clicks|impressions|ctr|position]
seoctopus keywords suggest  [-c country]
seoctopus keywords gaps -s  [--min-impressions 100] [--max-position 20]
seoctopus keywords cluster   [keyword3...]

# Competitive
seoctopus compete analyze  [-u yourUrl] [-n numCompetitors]
seoctopus compete gap   [competitorUrl2...]
seoctopus compete share  [keyword2...] -d 

# Scoring & Reports
seoctopus score  [-k keyword] [-p ga4PropertyId]
seoctopus report  [-k keyword] [-f json|markdown|html] [-o outputFile]

# Auth & Config
seoctopus auth setup -c 
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用于演示文稿的深色主题

技术栈

______________________________________________________________________

比较：SEOctopus与替代品

*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。

许可证

麻省理工学院——去建造一些东西。