Serpel

面向 AI 助手的 Serpel 插件

向 Claude、ChatGPT、Codex、Cursor、GitHub Copilot、VS Code 或 Gemini CLI 咨询自己网站的 SEO 数据。该插件将助手连接到 Serpel MCP 服务，并添加一个技能，说明何时使用哪个工具。

该插件仅包含清单和一个技能。不含程序代码，也不含钩子。

可以询问的内容

• 我有哪些项目？每个项目的健康状况如何？
• 自上次排名检查以来，哪些关键词排名上升或下降了？
• 与上一时段相比，Google Search Console 的点击次数和展示次数如何？
• 哪些搜索查询排名在第 4 至第 20 位，是快速见效的机会？
• 竞争对手在哪些方面排名比我高？
• 最近一次抓取发现了哪些技术问题？我应该优先修复什么？
• 我的网站在 ChatGPT 答案和 Google AI Overviews 中被引用或提及的频率如何？
• 我的抓取或排名检查完成了吗？
• 可选，消耗点数：获取包含搜索量、难度和意图的关键词创意。

工具

工具	用途	费用
list_projects	列出你账户中的项目及其 ID 和域名	免费
get_project_overview	审核得分、排名、AI 可见度、任务和后续步骤	免费
get_keyword_rankings	已跟踪的关键词及其排名和变化	免费
get_search_performance	Search Console 或 Bing 的点击次数、展示次数、点击率和排名	免费
find_keyword_opportunities	展示次数不为零、排名在第 4 至第 20 位的搜索查询	免费
analyze_competitors	根据已存储结果进行可见度和正面对比	免费
get_crawl_issues	按严重程度列出最近一次抓取发现的问题	免费
get_ai_visibility	在 ChatGPT 答案和 Google AI Overviews 中的引用和提及情况	免费
get_job_status	后台任务的状态和结果	免费
get_seo_recommendations	按优先级排列的建议，附带影响、工作量和依据	免费
get_codebase_overview	根据代码库快照查看路由、元数据和线上页面映射	免费
get_conversion_performance	各着陆页的会话数、转化次数和转化率	免费
research_keywords	关键词创意和指标	点数

所有列表最多包含 25 行。工具只会读取你有权访问的项目数据，绝不会更改你的网站。

ChatGPT 不提供 research_keywords。在其他所有客户端中，使用该工具需要有效的 Starter 或 Pro 套餐，并启用工作区设置“Agents can spend credits”。Agent 适用每日点数上限，且会优先从月度套餐额度中扣除点数。

交互卡片

在支持显示 MCP Apps 的应用中，例如 ChatGPT 和 Claude，有四个工具会以交互卡片展示结果：get_keyword_rankings、get_crawl_issues、find_keyword_opportunities 和 get_ai_visibility。其他所有客户端（例如 Claude Code、Cursor、Codex 和 Gemini CLI）都会以文本形式显示相同的数据。卡片不会加载外部资源，打开的链接也只会指向 Serpel 控制面板。

设置

服务地址为 https://serpel.app/mcp（Streamable HTTP）。支持 OAuth 的客户端会在首次使用时打开浏览器窗口进行登录。你也可以在 Serpel 控制面板的 Settings、API tokens 下创建具有 mcp:read 权限（以及所需数据的读取权限）的 API 令牌，并将其作为 Authorization: Bearer <token> 发送。

Claude Code

claude mcp add --transport http serpel https://serpel.app/mcp

要从本地检出目录加载包含其技能的插件：claude --plugin-dir ./serpel-plugin。

ChatGPT 和 Codex

从插件目录安装插件，或在连接器设置中添加远程 MCP 服务 https://serpel.app/mcp，然后使用你的 Serpel 账户登录。

Cursor

在 .cursor/mcp.json 中添加服务，或从市场安装插件：

{
  "mcpServers": {
    "serpel": { "url": "https://serpel.app/mcp" }
  }
}

配合 GitHub Copilot 使用的 VS Code

在 .vscode/mcp.json 中添加服务，或从 MCP 库（@mcp）安装：

{
  "servers": {
    "serpel": { "type": "http", "url": "https://serpel.app/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/Serpelapp/serpel-plugin

文件

文件	用途
plugin.json, mcp.json, skills/serpel/SKILL.md	Agent Plugins 1.0：ChatGPT、Codex、Cursor、GitHub Copilot、VS Code
chatGpt/skills/serpel/SKILL.md	ChatGPT 应用目录专用技能，不包含关键词研究，因为 ChatGPT 不提供此功能
.claude-plugin/plugin.json, .mcp.json	Claude Code
gemini-extension.json	Gemini CLI
server.json	官方 MCP 注册表，名称为 app.serpel/mcp
assets/	图标

所有清单使用相同的版本。

隐私与支持

• 隐私政策：https://serpel.app/privacy
• 条款：https://serpel.app/terms
• 支持与联系：https://serpel.app/about#how-can-you-contact-serpel
• 法律声明：https://serpel.app/imprint

工具结果仅包含来自你的 Serpel 账户的数据。你可以随时在 Serpel 控制面板的 Settings、API、connected apps 下断开客户端。