跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 XOVI，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
XOVI Suite SEO 数据，只读：API 积分余额、任意域名的可见度指数（OVI）历史、排名关键词、排名价值和关键词历史，以及你项目的每日关键词监控。
试试这样问
XOVI 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → XOVI、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
XOVI
XOVI Suite SEO 数据，只读：API 积分余额、任意域名的可见度指数（OVI）历史、排名关键词、排名价值和关键词历史，以及你项目的每日关键词监控。
设置
设置大约需要 2 分钟。使用 XOVI API 需要 XOVI Pro、Business 或 Enterprise 账号。
- 在 XOVI Suite 中打开 Account > API Dashboard，创建你的个人 API 密钥。
- 把它粘贴到
XOVI_API_KEY。连接器每次调用https://suite.xovi.net/api时都会把它作为key参数发送。 - 安装连接器并运行不消耗积分的
xovi_get_credit_state来检查密钥。
可读取的内容：账号的 API 积分余额和使用上限；任意域名的每周域名分析：可见度指数（OVI）随时间的变化、域名或 URL 有排名的关键词（含排名、搜索量、CPC 和竞争度）、排名价值、排名历史、单个关键词的排名历史以及关键词的搜索结果页；以及你项目的每日关键词监控：含竞争对手的项目、标签、受监控的域名、带最新排名的受监控关键词、关键词的每日历史、某天受监控关键词的前 100 个结果，以及项目域名的监控 OVI。
积分：大多数调用按次或按行块从账号的 API 积分预算中扣除（参见 XOVI 参考文档中的各个函数）；只读取你自己账号数据的调用免费。大批量导出前，AI 会用 xovi_get_credit_state 和 xovi_get_limits 查看余额，保持较小的 limit，未经你同意不会循环查询大量域名。监控关键词名额单独计算：xovi_get_monitoring_keyword_limits。
每周域名分析：AI 先用 xovi_list_search_engines（每周，例如 google.de）选择搜索引擎主机，然后用 xovi_get_ovi_trend 查看可见度变化，用 xovi_list_ranking_keywords 查看域名的排名关键词，再用 xovi_get_ranking_value、xovi_get_ranking_trend，用 xovi_get_keyword_trend 查看单个关键词，用 xovi_get_keyword_serp 查看关键词的结果页。urlpattern 可以是一个主机（www.example.com）、全部子域名（example.com/*）或一个目录（www.example.com/blog/*）。每周数据在周日发布，date 就是那个周日。
每日监控：xovi_list_projects 给出项目哈希，xovi_list_labels 给出标签，间隔为 daily 的 xovi_list_search_engines 给出数字 sengineid；然后 AI 使用 xovi_list_monitoring_domains、xovi_list_monitoring_keywords、xovi_get_monitoring_keyword_trend、xovi_get_monitoring_serp 和 xovi_get_monitoring_ovi_trend。
只读：全部 17 个工具都只读取。你的 XOVI 项目不会有任何变化，因此无需确认，安装时也没有关闭的工具。
分页：limit 最多 1000 行；skip 按 limit 行为一页计数，因此 limit 为 100、skip 为 1 时返回第 101 到 200 行。结果中的 resultCount 是未筛选的总数。
常见错误：XOVI 以 HTTP 200 返回 apiErrorCode 和 apiErrorMessage，连接器会把它们转换为错误。key 上的 param invalid 表示 API 密钥错误或已删除；no permission 表示该密钥或套餐不能使用这个函数；cost error 表示积分预算已用完，需等下次充值；其他字段上的 param missing 或 param invalid 会指出需要修正的字段。result empty 是没有数据的成功调用，例如某个域名没有排名。
前提条件: XOVI_API_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 XOVI 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
xovi_get_credit_state | Get the API credit balance: credits per interval, additionally booked credits, credits used and left, and the last refill date |
xovi_get_limits | Get the usage limits of the XOVI account per tool area (name and value), e.g |
xovi_list_search_engines | List the search engines XOVI crawls: id, host (e.g. google.de), country and city |
xovi_get_ovi_trend | Get the weekly visibility index (OVI) history of a domain, subdomain, directory or URL in one search engine: date and staticOvi per week |
xovi_list_ranking_keywords | List the keywords a domain or URL ranks for in one search engine in a weekly crawl: keyword, best ranking URL, position, change to the… |
xovi_get_ranking_value | Get the ranking value of a domain or directory: its traffic value computed from positions, search volume, CPC and click share, for one week |
xovi_get_ranking_trend | Get the weekly history of a domain: number of ranking keywords, rankings and keywords on page one per date |
xovi_get_keyword_trend | Get the weekly ranking history of one keyword for a domain: date, position and ranking URL |
xovi_get_keyword_serp | Get the ranking URLs and positions for one keyword in a search engine (the search result page of the weekly crawl) |
xovi_list_projects | List the XOVI projects: hash (projhash for the monitoring OVI), name, main domain and competitors |
xovi_list_labels | List the labels with hash, name and categories; a hash is the labelid of the monitoring tools |
xovi_list_monitoring_domains | List the domains in the daily keyword monitoring, optionally for one search engine |
xovi_list_monitoring_keywords | List the keywords in the daily monitoring with their latest position, change to the previous day, ranking URL, universal search type… |
xovi_get_monitoring_keyword_trend | Get the daily ranking history of a monitored keyword for a domain: crawl date and time, position, change, URL and universal search type |
xovi_get_monitoring_serp | Get the top 100 search results of a monitored keyword on a day: domain, URL, page, position and universal search type |
xovi_get_monitoring_ovi_trend | Get the daily monitoring OVI history of a project domain, optionally per device, search engine, label or competitor |
xovi_get_monitoring_keyword_limits | Get how many monitoring keyword credits the account has in total and how many are used |
示例提示
- “过去 12 个月里，example.de 在 google.de 上的可见度指数是怎么变化的？”
- “www.example.de/blog/ 在哪些关键词上排在第一页？请附上搜索量和 CPC。”*
- “比较 example.de 和 competitor.de 最近一周的排名价值。”
- “我们项目中受监控的关键词，哪些从昨天起下降了超过 3 位？”
- “我们还剩多少 API 积分？上次充值是什么时候？”
下一步
这份指南对你有帮助吗?