IndexNow 自动提交脚本使用说明
什么是 IndexNow?
IndexNow 是由 Microsoft Bing 和 Yandex 联合推出的一个开放协议,允许网站所有者主动通知搜索引擎其内容的更新。支持的搜索引擎包括:
- Microsoft Bing
- Yandex
- Seznam.cz
- Naver (部分支持)
脚本功能
本脚本会自动:
- 读取构建后生成的
urls.txt
文件 - 验证 URL 格式
- 分批提交到 IndexNow API
- 提供详细的提交状态反馈
使用方法
方法一:集成在构建流程中(推荐)
bash
npm run build
构建完成后会自动提交 URL 到 IndexNow。
方法二:单独运行 IndexNow 提交
bash
npm run indexnow
方法三:直接运行脚本
bash
node scripts/submit-indexnow.js
配置说明
脚本中的重要配置:
INDEXNOW_KEY
: 你的 IndexNow API 密钥(已配置:d0e5e590c5be4b328486655bcaaabe0c)HOST
: 网站域名(已配置:www.bukenghezi.com)BATCH_SIZE
: 每批提交的 URL 数量(默认:1000)
必要文件
密钥验证文件:
public/d0e5e590c5be4b328486655bcaaabe0c.txt
- 内容:
d0e5e590c5be4b328486655bcaaabe0c
- 作用:验证你拥有网站的控制权
- 位置:https://www.bukenghezi.com/d0e5e590c5be4b328486655bcaaabe0c.txt
- 内容:
URLs 文件:
.vitepress/dist/urls.txt
- 由
generate-urls.js
自动生成 - 包含所有需要提交的 URL
- 由
状态码说明
200
/202
: 提交成功400
: 请求格式错误403
: API 密钥无效或无权限422
: URL 格式错误或域名不匹配429
: 请求频率过高
注意事项
- 异步处理: IndexNow 的处理是异步的,提交成功不代表立即生效
- 质量优先: 搜索引擎会根据内容质量决定是否索引
- 频率限制: 避免过于频繁的提交,脚本已内置延迟机制
- 域名验证: 确保密钥文件在网站根目录可访问
故障排除
密钥文件无法访问
确保 public/d0e5e590c5be4b328486655bcaaabe0c.txt
文件存在且内容正确。
URL 格式错误
检查生成的 URLs 是否都以 https://www.bukenghezi.com/
开头。
网络错误
检查网络连接,必要时稍后重试。
API 限制
如果遇到 429 错误,请减小 BATCH_SIZE 或增加延迟时间。
监控提交状态
你可以在以下地方查看提交状态: