MCP 工具 Reference
每个 MCP 工具及其真实输入 schema 与所需 scope——由 server 定义自动生成。
这些工具由 AIEO.ee MCP 端点提供（POST /mcp，streamable HTTP，Bearer API key）。
本页由 server 注册的同一份定义自动生成——不会漂移。
接入方法见开发者指南。
list_projects
列出本 AIEO.ee 组织中的项目（网站）及其 ID。
Scope： read
无参数。
query_rankings
获取跟踪关键词的当前/上期 Google 排名、搜索量、难度与意图。支持子串搜索。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
search | string | 否 | 关键词子串过滤 |
limit | integer (min 1, max 100) | 否 | 最大返回行数（默认 25） |
query_ai_visibility
获取项目在 AI 回答引擎中的可见性：提及率、引用率、各品牌 share of voice、分引擎明细。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
days | integer (min 1, max 90) | 否 | 回溯窗口天数（默认 14） |
analyze_citations
分析 AI 引擎在跟踪 prompt 中引用了哪些域名——揭示竞对为何被引用而你没有。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
days | integer (min 1, max 90) | 否 | 回溯窗口天数（默认 14） |
find_content_gap
列出内容缺口：竞对 top-10 有排名而本项目排名 >15 或完全没有的关键词，含估算流量。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
analyze_competitor
竞对基准：SEO 重叠 vs AI share of voice。可选 brandId 查看对方赢而你输的关键词。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
brandId | string | 否 | 指定竞对品牌 id |
get_audit_issues
最近一次技术 SEO 审计的问题（坏链、缺失 title/meta、schema 缺口）及严重度与修复建议。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
generate_seo_plan
产出结合 GEO + SEO + 内容 + 技术发现的优先级增长计划，含项目 Growth Score。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
discover_competitors
从存量 SERP 快照中发现与本项目反复共同出现在 Google SERP 的竞对域名。返回重叠关键词、搜索量、平均排名与竞争分。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
days | integer (min 7, max 90) | 否 | 快照回溯天数（默认 30） |
min_days | integer (min 1, max 10) | 否 | 最少共现天数（默认 2） |
analyze_competitor_domain
下钻单个被发现的竞对域名：共现关键词、搜索量与双方排名。
Scope： read
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
domain | string | 是 | 竞对域名，如 kinsta.com |
generate_content_brief
为一个内容缺口生成完整 SEO 内容 brief（大纲、实体、FAQ）。WRITE 操作——需要 write scope 的 API key。用 find_content_gap 获取 gap ID。
Scope： write —— 需要带 write scope 的 API key。
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
project_id | string | 否 | 项目 ID（缺省用组织第一个项目；可用 list_projects 列出） |
gap_id | string | 是 | 来自 find_content_gap 的内容缺口 ID |