准备工作：为GitHub Actions配置百度收录环境
要让GitHub Actions自动将内容推送到百度搜索引擎，首先需要在仓库中配置必要的密钥。你需要在GitHub仓库的Settings → Secrets and variables → Actions中新增两个机密变量：BAIDU_SITE（你的站点地址）和BAIDU_TOKEN（百度搜索资源平台提供的推送令牌）。这两个变量是后续自动化脚本与百度接口通信的凭证，务必妥善保管，不要直接写在代码中。
编写GitHub Actions工作流文件
在仓库根目录下创建.github/workflows/baidu-push.yml文件，这是触发自动发布的核心配置。一个典型的工作流示例如下：
- 触发时机：一般设置为
push到主分支或release创建时触发，也可以添加schedule定时任务实现周期性提交。 - 运行环境：选择
ubuntu-latest，安装Node.js（用于运行脚本）和curl（用于发送请求）。 - 执行步骤：检出代码 → 安装依赖 → 生成站点地图（sitemap）或整理待推送URL列表 → 调用百度推送API。
生成并推送URL列表
在Actions中自动推送前，需要确定哪些URL是新增或更新的。推荐两种方式：
- 基于静态文件变化：使用
git diff检测最近一次提交中新增或修改的.html文件，提取其相对路径拼接成完整URL。 - 基于站点地图：在构建阶段自动生成
sitemap.xml，然后解析其中的<loc>标签获取所有URL。
接着利用curl将URL列表以POST方式发送到百度接口：
curl -H "Content-Type:text/plain" --data-binary @urls.txt "http://data.zz.baidu.com/urls?site=${{ secrets.BAIDU_SITE }}&token=${{ secrets.BAIDU_TOKEN }}"
注意：每次推送的URL数量建议不超过2000条，百度对单次请求有数量限制。
处理推送结果与错误重试
百度API会返回类似{"success": 10, "remain": 49990}的JSON响应。你可以在工作流中解析该结果：
- 如果
success小于提交数量，说明部分URL提交失败，需要记录失败的URL以便下次重推。 - 如果
remain值为0，则表示当日配额已用完，应当停止推送并设置下次触发间隔。 - 常见错误码如
401（令牌错误）或404（站点未验证），需要检查Secrets配置是否正确。
建议在脚本中加入重试逻辑，针对网络超时等临时错误最多重试3次，每次间隔5秒。
优化百度收录效率的附加策略
除了自动推送，以下措施能提升收录成功率：
| 策略 | 说明 |
|---|---|
| 提高网页加载速度 | 压缩CSS/JS、启用CDN，百度抓取时响应越快越容易被收录 |
| 完善内链结构 | 每个页面至少有2-3个指向其他相关页面的链接，方便爬虫遍历 |
| 合理设置robots.txt | 确保没有误屏蔽百度爬虫，同时指定sitemap位置 |
| 保持内容更新频率 | 制定定期发布计划，配合Actions定时任务持续推送新链接 |
值得注意的是，推送仅是将URL提交给百度“建议抓取”，不能保证立即收录。通常需要结合百度搜索资源平台的索引量数据，观察收录趋势并调整推送频率。
验证自动发布是否生效
工作流运行完成后，可以通过以下方式检查：
- 在GitHub Actions页面查看日志，确认
curl命令返回了正常JSON且包含"success"字段。 - 登录百度搜索资源平台，在“链接提交”→“推送记录”中查看当天提交的URL数量和状态。
- 等待1-2天后，使用
site:yourdomain.com搜索，观察新增页面是否出现在结果中。
如果发现提交成功但长期没有收录，可以检查页面是否带有noindex标签、是否存在大量重复内容，或尝试手动提交几篇优质原创内容激活站点权重。
评论区
热门讨论 · 占位展示期待你的精彩发言。