做过百度SEO的人都体会过那种焦虑：文章发出去了，百度迟迟不来抓。去站长平台一看，上次抓取是三天前。你手动提交了URL，等了半天，还是没动静。
百度给站长提供了三条让内容被发现的通道——手动提交、sitemap、API主动推送——但效率差距非常大。手动提交一天几十条封顶，sitemap百度几天才来抓一次，只有API主动推送能做到"文章发布后秒级通知百度"。这篇文章把三种推送方式的代码实现、WordPress集成方案、以及推送后怎么验证是否生效，全部讲清楚。
三种推送方式对比
| 推送方式 | 实现方式 | 日推送上限 | 百度响应速度 | 自动化程度 |
|---|---|---|---|---|
| API主动推送 | POST接口调用 | 约3000条/天（随推送质量动态调整） | 最快，分钟级 | 完全自动化 |
| JS自动推送 | 页面嵌入JS代码 | 无明确上限（被动触发） | 中等，需用户访问才触发 | 半自动（依赖访问） |
| 手动提交 + Sitemap | 站长平台操作 / XML文件 | 手动约20条/天，sitemap无上限 | 最慢，天级甚至周级 | 手动 / 半自动 |
一、拿到接口地址和Token——一切推送的前置条件
不管用哪种方式推送，第一步都是在百度搜索资源平台（ziyuan.baidu.com）完成两件事：
步骤一：验证站点所有权
添加站点 → 选择验证方式（推荐"文件验证"或"CNAME验证"）→ 按提示操作 → 验证通过。这一步不完成，后面所有的推送接口都用不了。
步骤二：获取接口调用地址
进入"普通收录"（或"快速收录"，如果站点有权限）→ 找到"API提交"板块 → 你会看到一个类似这样的接口地址：
http://data.zz.baidu.com/urls?site=你的域名&token=你的token
site后面是你的域名，token后面是一串字符。这串字符就是你的身份凭证，不要泄露。
快速收录 vs 普通收录：快速收录是百度给"优质站点"的专属通道，每天有10条配额，收录速度快（通常几分钟到几小时内）。普通收录所有验证过的站点都有，配额根据推送质量动态调整。新站一般只有普通收录权限。
二、API主动推送：四种语言的代码实现
API推送的核心就是把URL列表通过HTTP POST发送到百度给你的那个接口地址。下面是四种最常用语言的实现代码。
PHP版（WordPress等PHP网站直接可用）
<?php/*** 百度API主动推送* 用法：在文章发布时调用 baidu_push($urls)*/function baidu_push($urls) {$api = 'http://data.zz.baidu.com/urls?site=你的域名&token=你的token';// 确保$urls是数组if (!is_array($urls)) {$urls = array($urls);}$ch = curl_init();$options = array(CURLOPT_URL => $api,CURLOPT_POST => true,CURLOPT_RETURNTRANSFER => true,CURLOPT_POSTFIELDS => implode("\n", $urls),CURLOPT_HTTPHEADER => array('Content-Type: text/plain'),CURLOPT_TIMEOUT => 10,);curl_setopt_array($ch, $options);$result = curl_exec($ch);$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);curl_close($ch);// 返回结果解析$response = json_decode($result, true);// 记录日志方便排查error_log(sprintf('[百度推送] HTTP:%d success:%d remain:%d',$httpCode,isset($response['success']) ? $response['success'] : 0,isset($response['remain']) ? $response['remain'] : 0));return $response;}// WordPress集成：文章发布/更新时自动推送add_action('publish_post', 'baidu_push_on_publish', 10, 2);function baidu_push_on_publish($post_id, $post) {// 只推送已发布的文章if ($post->post_status !== 'publish') return;// 获取文章链接$url = get_permalink($post_id);baidu_push(array($url));}Python版（适合定时任务批量推送）
import requestsimport jsondef baidu_push(urls, site, token):"""百度API主动推送urls: URL列表（list）site: 你的域名，如 www.example.comtoken: 百度站长平台获取的token"""api = f'http://data.zz.baidu.com/urls?site={site}&token={token}'headers = {'Content-Type': 'text/plain'}body = '\n'.join(urls)try:resp = requests.post(api, data=body.encode('utf-8'),headers=headers, timeout=10)result = resp.json()print(f"推送成功: {result.get('success', 0)} 条")print(f"今日剩余配额: {result.get('remain', '未知')} 条")return resultexcept Exception as e:print(f"推送失败: {e}")return None# 使用示例if __name__ == '__main__':urls = ['https://www.example.com/article/1.html','https://www.example.com/article/2.html','https://www.example.com/article/3.html',]baidu_push(urls, 'www.example.com', '你的token')Shell版（一条命令搞定，适合服务器定时任务）
#!/bin/bash# 百度主动推送 - Shell版# 用法: bash baidu_push.sh urls.txtSITE="你的域名"TOKEN="你的token"API="http://data.zz.baidu.com/urls?site=${SITE}&token=${TOKEN}"# 从文件读取URL列表（一行一个URL）URL_FILE="${1:-urls.txt}"if [ ! -f "$URL_FILE" ]; thenecho "URL文件不存在: $URL_FILE"exit 1fi# 发送POST请求RESULT=$(curl -s -X POST "$API" \-H "Content-Type: text/plain" \--data-binary "@$URL_FILE")echo "$RESULT" | python3 -m json.tool 2>/dev/null || echo "$RESULT"Node.js版
const https = require('http');function baiduPush(urls, site, token) {const body = Array.isArray(urls) ? urls.join('\n') : urls;const options = {hostname: 'data.zz.baidu.com',path: `/urls?site=${site}&token=${token}`,method: 'POST',headers: {'Content-Type': 'text/plain','Content-Length': Buffer.byteLength(body)},timeout: 10000};return new Promise((resolve, reject) => {const req = https.request(options, (res) => {let data = '';res.on('data', chunk => data += chunk);res.on('end', () => {try {const result = JSON.parse(data);console.log(`推送成功: ${result.success}条, 剩余: ${result.remain}条`);resolve(result);} catch(e) {reject(new Error(`解析响应失败: ${data}`));}});});req.on('error', reject);req.write(body);req.end();});}// 使用baiduPush(['https://www.example.com/post/1.html'],'www.example.com','你的token');三、百度返回结果怎么读——三个关键字段
API推送成功后，百度会返回一个JSON，里面有三个字段直接告诉你推送结果：
| 字段 | 含义 | 正常值 |
|---|---|---|
success | 本次成功推送的URL数量 | 等于你发送的URL数量 |
remain | 今日剩余可推送的URL数量 | 大于0，越接近0说明快用完了 |
error | 错误码（仅在失败时出现） | 正常情况下不存在这个字段 |
常见的返回示例：
// 成功返回{"remain":2987, "success":3}// 配额用完{"error":401, "message":"over quota"}// token错误{"error":400, "message":"site error"}// URL格式不对（比如包含了非本站域名的链接）{"error":400, "message":"url invalid"}推送失败最常见的原因，按出现频率排序：
1. 域名未验证或验证过期
百度每隔一段时间会重新检查站点验证状态。如果验证文件被删了或DNS记录改了，推送接口直接返回400。去站长平台重新验证即可。
2. URL格式不合法
URL必须包含协议头（http://或https://），域名必须和验证的站点一致。带了www和不带www算两个不同的站点，需要分别验证。
3. 今日配额用完
返回remain=0。配额是根据你历史推送的URL质量动态调整的——推送的URL被百度实际收录的比例越高，配额涨得越快。
四、WordPress自动推送：三种集成方式
WordPress是国内使用最广的CMS，下面三种方案从简单到完整，按需选择。
方案一：functions.php里加一段代码（最轻量）
把前面PHP版的代码复制到主题的 functions.php 文件末尾，替换域名和token。之后每次发布文章，WordPress会自动调用百度推送。
优点：零插件，不占资源。缺点：没有推送历史记录，出问题不好排查。
方案二：装"百度搜索推送管理"插件（有界面）
在WordPress插件市场搜索"百度搜索推送管理"或"Baidu Links Submit"，安装后在设置页面填入你的API接口地址。这个插件会在文章发布时自动推送，并且有推送日志可以查看每次推送的结果。
优点：有管理界面，能看到推送历史。缺点：多了一个插件，略微增加维护成本。
方案三：定时任务批量推送（最完整）
用前面Python版代码写一个脚本，每天凌晨通过crontab自动执行：
# crontab - 每天凌晨2点推送前一天发布但未推送的文章0 2 * * * python3 /opt/scripts/baidu_push_daily.py
脚本逻辑：从WordPress数据库查询最近24小时发布的文章 → 过滤掉已经推送过的 → 批量POST到百度API → 记录推送日志。
优点：完全自动化，有日志，支持补推。缺点：需要写一点Python代码。
五、JS自动推送：不写后端代码的方案
如果你的网站不方便加后端代码（比如纯静态网站、GitHub Pages），可以用百度提供的JS自动推送。在页面底部加一段JS代码，当用户访问这个页面时，JS会自动把当前页面的URL发给百度。
<script>(function(){var bp = document.createElement('script');var curProtocol = window.location.protocol.split(':')[0];if (curProtocol === 'https') {bp.src = 'https://zz.bdstatic.com/linksubmit/push.js';} else {bp.src = 'http://push.zhanzhang.baidu.com/push.js';}var s = document.getElementsByTagName("script")[0];s.parentNode.insertBefore(bp, s);})();</script>这段代码放在 </head> 闭合标签之前，或者直接放在 footer 里。它的工作原理是：被动触发——只有当有人访问了你的页面，JS才会执行推送。如果新页面没人访问，百度就不会收到通知。
所以JS自动推送的正确理解是：它是API推送的补充，不是替代。对于已经有流量的老页面，JS推送可以帮百度发现更新；对于零流量的新页面，还是得靠API主动推送。
六、怎么确认推送真的生效了
推送成功（success>0）不代表百度真的来抓了。要确认生效，看三个地方：
- 百度站长平台 → 普通收录 → 提交记录：这里能看到最近提交的URL数量和状态。如果显示"已抓取"或"已索引"，说明推送生效了。
- 百度站长平台 → 索引量工具：看索引量曲线，如果API推送后索引量有明显上升趋势，说明推送的URL被百度接受了。
- 服务器日志：查看Nginx/Apache的access.log，搜索
Baiduspider，看推送后多久有百度蜘蛛来访问你提交的URL。正常情况下，API推送后几分钟到几小时内会有抓取记录。
推送不等于收录。百度收到推送后，会评估页面质量——内容原创度、页面加载速度、是否有大量广告、URL结构是否合理——然后决定要不要收录。推送只是让百度"知道这个页面存在"，能不能收录取决于页面本身的质量。
推送配额的优化技巧
配额用完了怎么办？几个提升配额的方法：
- 只推有质量的页面：不要把所有页面都推上去。重复内容、空页面、404页面推上去只会拉低你的"推送质量分"，导致配额被降。
- 新页面优先：同一个URL不要反复推送。百度对已经抓取过的URL再次推送是忽略的，白白浪费配额。
- 结合sitemap使用：API推送负责"新内容秒级通知"，sitemap负责"全站URL兜底发现"。两者配合，一个快一个全。
- 同时推送Bing和Google：百度的推送代码写好了，顺便也把Bing和Google的推送加上——一个脚本推三个搜索引擎，不增加多少工作量。Bing的API地址：
https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlbatch
说穿了，百度主动推送这件事的价值不在"代码怎么写"——API就一个POST请求，写起来三行代码。真正的价值在"你有没有把推送嵌到发布流程里，让每次发文章都自动推送，而不是想起来才去手动提交一次"。
如果是WordPress站，最快上手的方式：把PHP版代码复制到functions.php里，替换域名和token，发一篇文章测试，去站长平台看提交记录有没有这条URL。整个过程不超过15分钟。
