IndexNow 提交

IndexNow 只需要在文章发布或更新后提交 canonical URL。项目脚本会从正式 XML sitemap 或本地构建产物读取 URL，并一次性提交给 IndexNow。

提交 Git 中新增和更新的文章

脚本只读取相对当前 HEAD 尚未提交的变更，包括已暂存、未暂存和未跟踪的新文章；URL 会保存到根目录的 indexnow-urls.txt：

npm run seo:indexnow:urls
INDEXNOW_KEY='<key>' npm run seo:indexnow:changed

这两个命令是分开的：第一个扫描 Git 工作区并写入 txt，第二个只提交已有 txt，不会重新扫描，也不会清空文件。

请在文章部署成功后再运行提交命令；IndexNow 通知抓取，不保证收录或排名。

也可以更改输出文件，或让提交脚本读取已有 txt（每行一个完整 URL）：

node scripts/changed-article-urls.mjs --output=/tmp/indexnow-urls.txt
INDEXNOW_KEY='<key>' npm run seo:indexnow -- --urls-file=/tmp/indexnow-urls.txt

首次配置

1. 生成一个 8-128 位、只含字母/数字/连字符的 key，例如：

   openssl rand -hex 16

2. 在 public/ 创建 <key>.txt，文件内容只能是 key 本身。提交并部署，使它可以通过 https://www.chatgpt-china-guide.com/<key>.txt 访问。

提交已部署文章

INDEXNOW_KEY='<key>' npm run seo:indexnow

脚本默认读取 https://www.chatgpt-china-guide.com/sitemap.xml，提交前会检查线上 key 文件内容是否匹配。

提交刚构建的 sitemap

npm run build
INDEXNOW_KEY='<key>' npm run seo:indexnow -- --sitemap=.vitepress/dist/sitemap.xml

也可以只提交指定 URL：

INDEXNOW_KEY='<key>' \
INDEXNOW_URLS='https://www.chatgpt-china-guide.com/chatgpt/example,https://www.chatgpt-china-guide.com/gemini/example' \
npm run seo:indexnow

不要提交重定向源、非 canonical 域名或草稿页。IndexNow 是“通知抓取”，不保证收录或排名；sitemap 和 robots.txt 仍需保持正常。