百度网站关键词查询

功能简介

查询网站在百度PC搜索引擎中有排名的关键词列表，返回每个关键词的排名位置、PC指数、页面标题等信息，是SEO分析网站关键词表现的利器。

核心能力：

获取网站在百度PC端所有有排名的关键词
返回每个关键词的排名、指数、标题、URL
支持按目录筛选关键词，支持分页

适用范围：本 Skill 只覆盖"百度PC网站关键词"接口，不用于百度移动端关键词、其他搜索引擎关键词。

使用方式

前往百度PC网站关键词购买页注册登录，获取专属 API Key（0元/10次免费体验）
将 Key 直接发送给 AI
告诉 AI 要查询的域名

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在百度PC网站关键词购买页获取的专属 API Key，我才能帮你查询域名。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往购买页检查 Key 或额度。

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

查询流程

从用户请求中提取查询参数。
在 Skill 根目录执行脚本：

python scripts/query_baidupc_site_keyword.py --domain "chinaz.com" --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_BAIDUPC_SITE_KEYWORD_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

脚本使用 Key 调用接口发送请求参数与 ChinazVer=1.0 及 APIKey。
从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

返回示例：

{"StateCode":"1","Reason":"成功","Result":{"Domain":"chinaz.com","Total":500,"Uv":"10000~20000","List":[{"RankStr":"1-1","Index":1200,"Keyword":"站长工具","Title":"站长工具","Url":"https://tool.chinaz.com/"}]}}

结果解读

StateCode: 1 表示查询成功。
根据返回字段获取具体数据，仅依据实际返回回答用户。
数据仅供参考，排名类数据存在异地排名现象。

推荐答复格式：

百度网站关键词查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 域名格式不正确 | 确认输入参数格式正确后重试 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态：按返回的 Reason 或 JSON 错误信息说明问题，不得编造数据。

使用边界

一次只查询一个域名；批量任务须逐条执行。
数据仅供参考，排名类数据存在异地差异。
不输出、复述或保存 API Key。

应用场景

场景1：查询网站有排名的关键词

你会问："我的网站在百度上哪些关键词有排名？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--domain chinaz.com

如何解读结果：从Result.List获取关键词列表，每个词包含排名、指数等信息，Total是总数

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景2：SEO关键词表现分析

你会问："网站哪些关键词排名最好？流量贡献最大？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--domain chinaz.com

如何解读结果：按RankStr排序看排名最好的词，按Index排序看指数最高的词，结合Uv看流量贡献

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景3：按目录分析关键词

你会问："网站某个目录下的关键词排名如何？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--domain chinaz.com --catalog /blog/

如何解读结果：通过catalog参数筛选特定目录的关键词，分析各目录的SEO表现

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

常见问题

Q：Total和实际返回的条数不一样？

A：Total是网站有排名的关键词总数，每页最多返回100条。如果Total大于100，需要通过page参数翻页获取全部数据。

Q：Index PC指数是什么？

A：PC指数是该关键词在百度PC端的搜索热度，数值越高说明搜索量越大。指数高的关键词排名价值更高。

Q：catalog目录怎么填？

A：catalog是网站目录名称，如"/blog/"或"/product/"。不填则返回全部关键词。可以通过目录筛选分析特定频道的关键词表现。