百度排名查询

功能简介

查询某个关键词在百度PC搜索引擎中排名前50的网站信息，包括排名位置、页面标题、描述、URL和关键词收录量，是SEO竞争分析的核心工具。

核心能力：

• 查询关键词百度PC端前50名网站排名
• 返回每个排名网站的标题、描述、URL
• 提供关键词总收录量

适用范围：本 Skill 只覆盖"百度PC前50名信息"接口，不用于百度移动端排名、特定域名排名查询。

快速开始

只需三步即可开始使用：

运行要求

• 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
• Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
• 能够向 https://openapi.chinaz.net 发起 HTTPS 请求。
• 运行 AI 客户端的环境可读取环境变量。

如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。

获取与配置 API Key

第一步：购买接口

在 百度PC前50名信息购买页 购买接口并获取专属 API Key。该接口提供 0元/10次 的免费体验额度，适合先试用再决定是否购买付费套餐。

第二步：设置环境变量

将 Key 保存为环境变量，变量名必须是：

CHINAZ_BAIDUPC_TOP50_API_KEY

Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。

macOS / Linux（当前终端会话临时生效）：

export CHINAZ_BAIDUPC_TOP50_API_KEY='你的专属APIKey'

如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。

第三步：重启生效

重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

安全提醒：不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

参数说明

| keyword | string | 必填 | 获取的关键词 | 站长 |

查询流程

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

python scripts/query_baidupc_top50.py --keyword "站长"

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用接口 https://openapi.chinaz.net/v1/1001/baidupc_keywordtop50，发送请求参数与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

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

| StateCode | int | 状态码 | | Reason | string | 状态说明 | | SiteCount | int | 关键词收录量 | | RankStr | string | 排名（页数-条数） | | Title | string | 标题 | | Url | string | 标题连接 | | Description | string | 描述 |

返回示例：

{"StateCode":1,"Reason":"成功","SiteCount":10000000,"Ranks":[{"RankStr":"1-1","Title":"站长工具 - 站长之家","Url":"https://tool.chinaz.com/","Description":"站长工具提供SEO工具..."}]}

结果解读

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

推荐答复格式：

百度排名查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

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

使用边界

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

应用场景

场景1：查询关键词排名情况

你会问：""站长"这个关键词百度上排前50的都是哪些网站？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 站长

如何解读结果：从Ranks列表获取前50名网站信息，RankStr是排名，Title和Url是网站信息

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

场景2：SEO竞争分析

你会问："这个关键词竞争激烈吗？排在前面的都是什么网站？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 目标关键词

如何解读结果：分析前50名网站的类型和质量，SiteCount看收录量判断竞争度

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

场景3：关键词优化难度评估

你会问："这个词好不好做？需要超过哪些网站？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 目标关键词

如何解读结果：通过前50名网站的质量和权重评估优化难度，制定超越策略

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

常见问题

Q：前50名数据多久更新一次？

A：排名数据存在异地排名现象，不保证与查询IP百分百一致。数据会定期更新，但不是实时的。

Q：收录量SiteCount很高意味着什么？

A：SiteCount表示该关键词的搜索结果总数，数值越高说明竞争越激烈，优化难度越大。

Q：查不到排名数据怎么办？

A：可能是关键词太新或搜索量太低。尝试换一个更常见的关键词查询。