Miraqo

Miraqo MCP 服务

将 Claude、ChatGPT、Gemini、Claude Code 或 Cursor 连接到你在 Miraqo 中的 SEO 数据——排名、技术审计、反向链接、竞争对手、 Search Console 和 AI 可见度——然后在你已经使用的聊天应用中用日常语言查询这些数据。

这是一个托管式远程 MCP 服务。无需安装，也无需在本地运行任何内容。本仓库仅包含文档。

https://app.miraqo.io/mcp

你需要一个 Miraqo 账户。可免费试用 14 天，无需绑定银行卡。

---

设置

claude.ai、ChatGPT、Gemini——一键连接

添加一个自定义连接器，并粘贴上方地址。标准 OAuth 授权会自动启动：登录 Miraqo，确认，即可完成。无需生成或粘贴令牌。

各应用中添加连接器的位置略有不同（也可能取决于你在该应用中的套餐），但地址始终相同。

你可以随时在账户设置 → AI 连接器 (MCP) → 已连接的应用中撤销访问权限。

Claude Code

在账户设置 → AI 连接器 (MCP) 中生成个人令牌，然后：

claude mcp add --transport http miraqo https://app.miraqo.io/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor 和其他基于令牌的客户端

{
  "mcpServers": {
    "miraqo": {
      "url": "https://app.miraqo.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

令牌仅在创建时显示一次。最多可保留 5 个有效令牌，并可逐个撤销。

---

工具

共有 26 个工具。先使用 list_projects 获取其他工具所需的 project_id。

读取——不会消耗套餐额度

工具	返回内容
list_projects	你的项目，以及每个项目最近一次审计的信息（ID、状态、日期、评分）
get_usage	本月至今相对于套餐限额的用量，包括 MCP 操作上限
get_keywords	已跟踪关键词的最新排名、URL 和 AI Overview 是否展示
get_keyword_history	单个关键词最多 365 天的排名历史，含 SERP 功能
get_competitors	已跟踪竞争对手的平均排名和关键词差距规模
get_keyword_gap	竞争对手排名所涉及的关键词，含搜索量、难度和 CPC
get_domain_analysis	任意域名的缓存竞争快照：权威度、自然搜索关键词、热门页面
get_backlinks	最新反向链接快照：新增、丢失、引用域名、锚文本、垃圾评分
get_audit_overview	评分、已抓取页面数，以及最近一次审计的结果
get_audit_issues	非零问题计数：404、标题、重复内容、安全、站点地图
get_audit_pages	各页面的状态、标题、字数、加载时间/LCP/TTI 和问题标记
get_audit_redirects	重定向链及 linked_from——需要修复的页面
get_cwv_report	Core Web Vitals：实验室和真实用户数据，以及 LCP 最差的页面
get_topical_architecture	主题集群及其支柱页面，可为结构生成或 AI 优化
get_cluster_pages	集群中的页面，按入站内部链接数量排序
find_pages	按 URL 或标题子串搜索已抓取页面
get_ai_visibility	AI 助手是否提及你的品牌并引用你的 URL，以及品牌声量占比
get_gsc_performance	按查询词或页面查看 Search Console 数据，汇总为 7/28/90 天窗口
get_gsc_daily	Search Console 每日网站总量——用于对比下降前后数据的时间序列

操作 — 消耗计划配额

每项操作还会计入 MCP 发起操作的单独月度上限。运行前请检查 get_usage。

工具	功能
run_audit	启动新的技术爬取。费用按实际分析的页面数量扣除审核额度
run_keyword_research	按种子词、列表、域名或与竞争对手的差距，查询搜索量、难度和 CPC
run_domain_analysis	刷新竞争态势快照。7 天内的快照可免费复用
run_ai_visibility_check	重新运行项目的 AI 可见度提示词
add_ai_prompt	创建 AI 可见度提示词并运行首次检查
refine_topical_architecture	使用 AI 分析审核中的主题集群。每次审核限用一次
generate_topical_bridge	撰写一段链接文字，用于连接两个页面。缓存中的页面对可免费使用

读取操作不计量，因此探索数据无需付费。

---

REST API

相同功能也可通过 /api/v1 下有文档说明的 REST API 使用，适用于非 MCP 客户端的集成。链接位于账户设置中的 AI Connector 卡片内。

说明

• 工具说明目前以意大利语提供。Miraqo 界面支持意大利语、英语、德语、法语和西班牙语。
• 数据范围遵循你的账户设置：服务端只会公开经过身份验证的令牌有权查看的项目，并遵守每位用户的项目权限。

链接

• miraqo.io
• AI Connector 指南
• 询问有关你数据的问题
• 定价

欢迎在此提出有关连接器的问题或反馈问题。有关账户或账单事宜，请发送邮件至 [email protected]。