Claude Code 集成 SE Ranking 扩展在 ChatGPT、Gemini、Perplexity 与 Google AI 平台追踪 AI Share-of-Voice 的完整配置指南【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo本文是 claude-seo 项目中 SE Ranking 扩展的完整安装与实战指南。SE Ranking 扩展为 Claude Code 提供跨 ChatGPT、Gemini、Perplexity、Google AI Overviews 与 AI Mode 五大 AI 平台的AI Share-of-VoiceAI 声量份额追踪能力并顺带补足传统 SERP、外链与竞争对手数据。读完本文你将掌握该扩展的安装、验证、密钥轮换、卸载全流程理解其单位计费模型与成本护栏并能基于源码级证据判断评分字段、安全写入机制与测试保障直接落地到自己的 AI 可见性监测工作流中。扩展定位claude-seo v2 扩展体系中的「AI 声量」能力SE Ranking 是 claude-seo 在 v2 阶段新增的 5 个扩展之一。根据 docs/MIGRATION-v1-to-v2.md 中「AI search 5 new extensions (Phase E)」一节extensions/seranking/的定位被明确描述为AI Share-of-Voice across ChatGPT/Gemini/Perplexity/AI Overviews/AI Mode其核心卖点是SE Ranking 的 API 除了暴露传统 SEO 数据SERP、外链、竞争对手还额外提供跨 5 个 AI 平台的 AI 声量份额数据。项目文档称这是 2026 年任何一家供应商中最大的「AI 引用」覆盖面并且没有其他供应商能在同一个 API 表面上覆盖全部 5 个 AI 平台见 SKILL.md 的描述。需要说明的是这是项目自身文档的市场定位陈述具体覆盖面随 SE Ranking 服务更新而变化使用时以官方实际数据为准。从仓库结构看该扩展与其他 4 个新增扩展ahrefs、profound、bing-webmaster、unlighthouse保持完全一致的目录规范install.sh/install.ps1/uninstall.sh/skills/skill-dir/SKILL.md/docs/*-SETUP.md。这套结构被 tests/test_parasite_risk_and_extensions.py 的test_extension_has_install_skill_and_docs逐一校验属于项目级的扩展质量门槛。安装前置条件在运行安装器之前请确认已安装 claude-seo 基础插件。安装器会检查~/.claude/skills/seo目录是否存在不存在则直接报错退出。这是扩展依赖基础 SEO skill 的设计约束避免在裸 Claude Code 环境中安装出「孤立技能」。已安装 Python 3。install.sh通过command -v python3检测缺失时提示✗ Python 3 required.并退出。已获取 SE Ranking API Key。从 SE Ranking 官方 API 页面seranking.com/api申请下文详述计费方式。安装Linux / macOS 与 Windows 双平台Linux / macOS./extensions/seranking/install.shWindowsPowerShell.\extensions\seranking\install.ps1安装器实际做了什么结合 install.sh 源码安装流程可分解为四步交互式读取 API Key隐藏输入read -rsp SE Ranking API key: SR_KEY使用-s静默模式密钥不会回显到终端空输入会被拦截✗ No key provided.。Windows 版 install.ps1 则使用Read-Host -AsSecureString获取安全字符串再经NetworkCredential解码为明文供 Python 写入。复制技能文件将skills/seo-seranking/SKILL.md复制到~/.claude/skills/seo-seranking/SKILL.md使 Claude Code 在运行/seo seranking ...命令时能加载该技能定义。写入 API Key 到全局配置通过内嵌 Python 脚本在~/.claude/settings.json的env对象中设置SERANKING_API_KEY。脚本采用「临时文件 原子替换」策略tempfile.mkstemp创建临时文件 → 写入 JSON →os.chmod(tmp, 0o600)收紧权限 →os.replace(tmp, path)原子替换。这样即使写入中途失败也不会破坏已有的settings.json。回显结果提示安装成功并给出试用命令/seo seranking ai-visibility brandname与文档路径。关于0o600权限位~/.claude/settings.json中保存的是明文 API 密钥以0o600仅当前用户可读写保护与 Google/DataForSEO 等密钥类扩展的安全策略一致。需要留意的是安装器会在原有 JSON 基础上保留并合并其他配置项data.setdefault(env, {})不会清空你已有的设置。获取 API Key 与计费模型SE Ranking API 采用unit单位计费而非订阅内无限调用。关键成本信息如下项目说明获取入口seranking.com/api 官方 API 页面申请计费粒度按 API 调用消耗 units不同端点单价不同AI 可见性端点单次查询约5 units5 个 AI 平台各 1 unit成本监控使用仓库内 scripts/dataforseo_costs.py 跨供应商记账由于单次 AI 声量查询横跨 5 个平台ChatGPT、Gemini、Perplexity、AI Overviews、AI Mode成本是传统单端点查询的约 5 倍这也是项目在 SKILL 中专门设置成本护栏的原因见下文「成本护栏」小节。验证安装跑一次真实的 AI 声量查询安装完成后在 Claude Code 中执行/seo seranking ai-visibility Claude SEO预期输出为每个平台的声量百分比ChatGPT、Gemini、Perplexity、AI Overviews、AI Mode并附带基于样本量的置信度说明。例如你会看到形如chatgpt_sov: 42%、gemini_sov: 18%之类的字段值每个百分比都配有「样本量较小 / 样本量充分」之类的置信度注释避免把低样本结果当成高置信结论。如果该命令提示缺少密钥SKILL 的 Prerequisites 会引导你检查~/.claude/settings.json中env.SERANKING_API_KEY是否存在缺失时直接运行安装器即可。核心命令路由一扩展四命令SE Ranking 技能SKILL.md定义了 4 个路由命令命令用途/seo seranking ai-visibility brand查询brand在 ChatGPT、Gemini、Perplexity、AI Overviews、AI Mode 五个平台的声量份额/seo seranking serp keyword获取关键词的 Top 100 自然排名 SERP 特性feature/seo seranking backlinks url查询外链画像作为 Ahrefs / DataForSEO 的免费档替代方案/seo seranking competitors url获取 Top 10 自然竞争对手与共享关键词缺口其中serp、backlinks、competitors属于 SE Ranking API 的传统 SEO 数据面与仓库内 skills/seo-backlinks/ 等技能的数据口径互补而ai-visibility才是本扩展的差异化能力下面单独展开。AI Share-of-Voice 评分机制深入SE Ranking 的 AI 声量评分逻辑是对一组可配置的提示词集prompt set分别在每个 AI 平台采样其回复统计品牌提及brand mention出现的比例。该打分器与 Profound / Peec AI 使用同一套逻辑但被打包进同一个 MCP/API 表面这也是项目将其与 extensions/profound/ 区分开的依据——Profound 做的是时间序列的 LLM 引用追踪见 docs/MIGRATION-v1-to-v2.md 对 profound 的定位描述而 SE Ranking 提供的是开箱即用的多平台单次查询。输出字段共 5 个含义如下字段含义chatgpt_sov采样提示词中品牌出现在 ChatGPT 回复里的百分比gemini_sov同上针对 Google Geminiperplexity_sov同上针对 Perplexityai_overviews_sov品牌在 Google AI Overviews 中的引用率ai_mode_sov品牌在 Google AI Mode 中的引用率当前以美式英语为优先语料报告规范SKILL 明确要求每个字段都报告为百分比并根据样本量给出置信度说明。样本量越大百分比越可信样本量偏小时应标注低置信度防止误导决策。需要强调ai_mode_sov的「US English first」说明 AI Mode 语料当前以美国英语为优先中文/其他语系品牌在解读该字段时需考虑语料偏差。成本护栏跨供应商记账因为 AI 声量查询单次约 5 unitsSKILL 的成本护栏小节明确要求Usescripts/dataforseo_costs.pyto log spend across vendors.scripts/dataforseo_costs.py 是一个通用的 API 成本估算、审批与预算跟踪脚本支持以下子命令python scripts/dataforseo_costs.py estimate endpoint [--count N] # 调用前估算成本 python scripts/dataforseo_costs.py check endpoint [--count N] # 阈值审批检查 python scripts/dataforseo_costs.py log endpoint cost [--note TEXT] # 记录实际花费 python scripts/dataforseo_costs.py summary [--days N] # 汇总消费 python scripts/dataforseo_costs.py today # 今日消费 python scripts/dataforseo_costs.py config [--mode always|threshold|none] [--threshold AMOUNT] [--daily-limit AMOUNT] python scripts/dataforseo_costs.py reset其数据落盘于~/.config/claude-seo/dataforseo-costs.json配置与~/.config/claude-seo/dataforseo-ledger.json账本支持 always / threshold / none 三种成本控制模式。虽然脚本以 DataForSEO 命名但 SKILL 明确将其用作跨供应商含 SE Ranking的统一记账入口——在 Claude Code 会话中把 SE Ranking 的每次 5-unit 查询记入账本即可形成全厂商的成本可观测性。密钥轮换与安全机制SE Ranking 密钥需要轮换时直接重新运行安装器即可。其安全设计要点原子覆盖安装脚本用「tempfile os.replace」写回env.SERANKING_API_KEY轮换过程不会产生半写入的 JSON也不会触碰其他设置项旧值被整体替换而非追加残留。隐藏输入Linux/macOS 用read -rspWindows 用Read-Host -AsSecureString密钥全程不回显。权限收紧写入后的 settings 文件为0o600仅当前用户可读写。轮换完成后旧密钥立即失效settings 中已覆盖建议同时顺带验证一次/seo seranking ai-visibility以确认新密钥可用。卸载./extensions/seranking/uninstall.sh对照 uninstall.sh 源码卸载做两件事删除技能目录~/.claude/skills/seo-seranking/用同样的 tempfile os.replace原子方式从~/.claude/settings.json的env中移除SERANKING_API_KEY保留其余所有配置。注意卸载脚本同样要求存在~/.claude/settings.jsonjson.load不存在的文件会异常如果 settings 文件已被手动删除需先确认或重建后再执行卸载。与其他技能的协作边界SE Ranking 扩展并非孤立工作SKILL 的 Cross-skill delegation 给出了明确的协作路由传统外链 内容审计回退到seo-backlinks/seo-content技能即 skills/seo-backlinks/ 与 skills/seo-content/SE Ranking 的外链数据作为免费档替代/交叉验证不做深度审计主引擎。单平台深度分析如果只需要 ChatGPT 或 Perplexity 单平台深挖优先使用seo-geo技能skills/seo-geo/它带有 Brand Mention Correlation品牌提及相关性指导且其参考文档 skills/seo-geo/references/llmstxt-evidence.md 引用了包括 SE Ranking 在内的行业证据源。这条路由的意图很清晰SE Ranking 负责「5 平台一次性快照」与成本可控的日常监测而深度的单平台分析交给 GEO 专项技能避免在单平台场景下重复烧掉 5 份 units。质量保障扩展结构测试SE Ranking 扩展的质量并非仅靠文档承诺tests/test_parasite_risk_and_extensions.py 提供了结构级保障test_extension_has_install_skill_and_docs参数化覆盖 seranking断言install.sh、install.ps1、skills/seo-seranking/SKILL.md、uninstall.sh存在且docs/目录下至少有一个*-SETUP.md。test_extension_install_script_is_executable与test_every_extension_install_and_uninstall_is_executable校验脚本具有可执行位chmod x。test_extension_skillmd_has_required_frontmatter断言 SKILL.md 的 frontmatter 包含name: seo-seranking、description:、metadata:块且版本号声明为2.2.0与项目 v2 的版本规范保持一致。也就是说任何一次扩展结构回归都会被 CI 测试拦住——这保证了「安装 → 验证 → 轮换 → 卸载」这条路径始终可执行、可复现。小结SE Ranking 扩展以约 5 units/次的成本为 claude-seo 提供了「一次查询、五平台声量」的 AI 可见性能力并用传统 SERP / 外链 / 竞争对手数据补齐了日常 SEO 数据面。从安装器的原子写入与0o600权限保护到 SKILL 的置信度报告规范与成本护栏再到测试套件的结构校验整个扩展的工程闭环完整。建议的使用姿势是日常用/seo seranking ai-visibility做品牌 AI 声量快照与趋势监测用scripts/dataforseo_costs.py记账单平台深挖时切换到seo-geo。配置过程中如需查阅更多细节仓库内 SERANKING-SETUP.md 与 SKILL.md 是两份最直接的权威参考。【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考