使用 GitHub Actions 自动提交 URL 到 IndexNow

作为静态博客（比如Hexo/Hugo搭建的博客或静态网站）博主，你一定遇到过发布新文章后，搜索引擎迟迟不收录的问题。手动提交链接到搜索引擎不仅繁琐，还容易遗漏；而IndexNow协议（由Bing/Yandex等搜索引擎推出）能让搜索引擎快速发现并收录你的网站内容，结合GitHub Actions的自动化能力，可实现博客发布即自动推送多搜索引擎，彻底解放双手。

本文将从核心概念入手，一步步教你用GitHub Actions实现博客内容自动推送到Bing IndexNow，兼顾实用性和可扩展性。

注意：如果博客无Github仓库，可以创建一个空仓库，再按照本文步骤配置GitHub Actions（无需博客代码）。
本文以用Github+Vercel+Hexo搭建的博客为例，其他静态博客搭建方式类似。

核心概念速览

GitHub Actions与CI/CD

CI/CD（持续集成/持续部署）是DevOps的核心实践，而GitHub Actions是GitHub内置的CI/CD工具，无需额外服务器，只需在仓库中编写yml格式的工作流文件，就能实现代码推送、定时任务等触发的自动化操作（比如博客构建、部署、搜索引擎推送）。

IndexNow：搜索引擎快速收录的利器

IndexNow是一套开放的协议，核心作用是：网站内容更新后，主动通知搜索引擎，搜索引擎会快速抓取并更新索引，相比传统的sitemap定期抓取，收录效率提升数倍。

• 核心优势：免费、实时、跨搜索引擎（支持Bing、Yandex等）；
• 工作原理：
  1. 生成唯一API Key，并将Key以{key}.txt的形式放在网站根目录（验证网站归属）；
  2. 向IndexNow API提交更新的URL列表，附带API Key和网站域名；
  3. 搜索引擎验证Key合法性后，立即抓取并收录URL。

实操步骤：GitHub Actions自动推送IndexNow

前期准备

1. 获取IndexNow API Key
   访问Bing IndexNow官网，点击Generate API Key生成唯一Key（比如0a1818e0fea342e09e060743f4da9b44）。

生成API Key截图

2. 验证网站归属
   创建一个名为{你的API Key}.txt的文件（比如0a1818e0fea342e09e060743f4da9b44.txt），文件内容仅需填写你的API Key，然后将该文件上传到博客根目录（比如https://jackie.openenet.cn/0a1818e0fea342e09e060743f4da9b44.txt），确保能通过浏览器访问。
3. 准备Sitemap文件
   确保博客有可访问的Sitemap文件（支持xml或txt格式）：
   • sitemap.txt：每行一个完整URL（比如https://jackie.openenet.cn/xxx.html）；
   • sitemap.xml：符合标准XML格式的站点地图（下文代码已适配两种格式）。

配置GitHub Secrets

硬编码API Key会有泄露风险，需将敏感信息存到GitHub仓库的Secrets中：

1. 打开博客仓库 → 「Settings」→ 「Secrets and variables」→ 「Actions」→ 「New repository secret」；
2. 添加以下两个机密：
   • 名称：INDEXNOW_KEY，值：你的IndexNow API Key（比如0a1818e0fea342e09e060743f4da9b44）；
   • 名称：INDEXNOW_KEY_LOCATION，值：Key文件的访问地址（比如https://jackie.openenet.cn/0a1818e0fea342e09e060743f4da9b44.txt）；
   • 可选补充：INDEXNOW_HOST（博客域名，比如jackie.openenet.cn）、SITEMAP_URL（Sitemap地址，比如https://jackie.openenet.cn/sitemap.txt）。

机密配置截图

编写GitHub Actions工作流文件

在博客仓库根目录创建.github/workflows/indexnow.yml文件，以下是完整代码：

# 工作流名称：提交博客URL到Bing IndexNow
name: Submit Blog URLs to Bing IndexNow

# 触发条件：
# 1. 推送到main分支（博客发布/更新时）；
# 2. 每天凌晨1点定时推送（补漏）；
# 3. 手动触发（应急使用）。
on:
  push:
    branches: ["main"]
    # 可选：仅当博客内容文件变更时触发（减少无效执行）
    paths:
      - "content/**"
      - "posts/**"
      - "source/**"
  schedule:
    - cron: '0 1 * * *'  # UTC时间，对应北京时间9点
  workflow_dispatch:  # 手动触发开关

# 权限配置：仅读取仓库内容（最小权限原则）
permissions:
  contents: read

# 定义任务
jobs:
  submit-to-indexnow:
    runs-on: ubuntu-latest  # 使用Ubuntu最新版运行环境
    steps:
      # 步骤1：安装依赖（jq用于处理JSON，curl用于请求，xmlstarlet用于解析xml sitemap）
      - name: Install dependencies
        run: |
          sudo apt-get update && sudo apt-get install -y jq curl xmlstarlet

      # 步骤2：延迟执行（仅push触发时）- 等待博客部署完成（避免推送未生效的URL）
      - name: Wait for blog deployment (only on push)
        if: github.event_name == 'push'
        run: sleep 60  # 延迟1分钟，可根据博客部署耗时调整

      # 步骤3：核心逻辑：获取Sitemap并推送到IndexNow
      - name: Fetch sitemap and submit to Bing IndexNow
        env:
          # 从GitHub Secrets读取敏感信息（避免硬编码）
          INDEXNOW_KEY: ${{ secrets.INDEXNOW_KEY }}
          INDEXNOW_KEY_LOCATION: ${{ secrets.INDEXNOW_KEY_LOCATION }}
          INDEXNOW_HOST: ${{ secrets.INDEXNOW_HOST || 'jackie.openenet.cn' }}
          SITEMAP_URL: ${{ secrets.SITEMAP_URL || 'https://jackie.openenet.cn/sitemap.txt' }}
        run: |
          # ========== 1. 参数校验 ==========
          echo "=== 校验配置参数 ==="
          if [ -z "$INDEXNOW_KEY" ] || [ -z "$INDEXNOW_KEY_LOCATION" ] || [ -z "$INDEXNOW_HOST" ] || [ -z "$SITEMAP_URL" ]; then
            echo "❌ 错误：缺少必要配置参数，请检查GitHub Secrets"
            exit 1
          fi
          echo "✅ 配置参数校验通过"
          echo "博客域名：$INDEXNOW_HOST"
          echo "Sitemap地址：$SITEMAP_URL"

          # ========== 2. 下载并解析Sitemap ==========
          echo -e "\n=== 下载并解析Sitemap ==="
          # 下载Sitemap文件
          if ! curl -s -o sitemap.tmp "$SITEMAP_URL"; then
            echo "❌ 错误：无法下载Sitemap文件（$SITEMAP_URL）"
            exit 1
          fi

          # 区分Sitemap格式（txt/xml）并提取URL
          if [[ "$SITEMAP_URL" =~ \.xml$ ]]; then
            # 解析xml格式Sitemap
            xmlstarlet sel -t -v "//url/loc" sitemap.tmp | grep "^https://$INDEXNOW_HOST/" | sort -u > valid_urls.txt
          else
            # 解析txt格式Sitemap（每行一个URL）
            grep -v '^

> 编写工作流文件截图
> ![编写工作流文件截图](/img/cicd-actions-indexnow/3.png)

### 测试与验证
1. **手动触发工作流**：
   仓库 → 「Actions」→ 找到「Submit Blog URLs to Bing IndexNow」→ 「Run workflow」→ 点击「Run workflow」，查看运行日志（绿色对勾表示成功）；

> 手动触发工作流截图
> ![手动触发工作流截图](/img/cicd-actions-indexnow/4.png)

2. **验证推送结果**：
   登录[Bing网站管理员工具](https://www.bing.com/webmasters)，在「IndexNow」板块可查看提交记录和处理状态。

## 常见问题与优化建议
### 常见问题排查
1. **Key验证失败**：检查`{key}.txt`文件是否能访问、文件内容是否仅为Key、Key是否与Secrets中一致；
2. **Sitemap解析失败**：确认Sitemap地址可访问、URL格式为完整的`https://`开头、域名与配置的`INDEXNOW_HOST`一致；
3. **HTTP状态码400/403**：
   - 400：JSON格式错误（检查URL列表是否为空）；
   - 403：Key验证失败（重新检查Key文件）；
   - 429：请求频率超限。

### 优化建议
1. **限制推送频率**：在`on.push.paths`中指定仅博客内容文件变更时触发，减少无效执行；
2. **拆分大批量URL**：如果URL数量超过1000，可在代码中拆分批次提交；
3. **多搜索引擎适配**：IndexNow协议支持多引擎，只需将API地址替换为对应引擎（如Yandex：`https://yandex.com/indexnow`）；

> 注意：在任意支持IndexNow的搜索引擎提交后，其它搜索引擎也可自动收录。

4. **增加失败重试**：添加`actions/github-script`实现失败自动重试（最多3次）。

## 总结
通过GitHub Actions + IndexNow的组合，你实现了「博客内容更新→自动推送→搜索引擎快速收录」的全自动化流程，核心优势：
1. 无需手动操作，彻底解放双手；
2. 避免硬编码敏感信息，符合安全最佳实践；
3. 适配多种Sitemap格式，兼容性强；
4. 详细的日志输出，便于故障排查。

这套思路也可延伸到其他自动化场景（比如博客自动部署、图片压缩、链接检查），CI/CD的核心价值就是让重复的工作自动化，让你专注于内容创作而非繁琐的运维操作。 sitemap.tmp | sort -u | grep "^https://$INDEXNOW_HOST/" > valid_urls.txt
          fi

          # 检查有效URL数量
          if [ ! -s valid_urls.txt ]; then
            echo "❌ 错误：未提取到有效URL（请检查Sitemap格式和域名）"
            exit 1
          fi
          VALID_URL_COUNT=$(wc -l < valid_urls.txt)
          echo "✅ 提取到有效URL数量：$VALID_URL_COUNT"
          # 打印前5个URL（便于调试）
          echo "前5个有效URL："
          head -5 valid_urls.txt

          # ========== 3. 构造IndexNow API请求数据 ==========
          echo -e "\n=== 构造API请求数据 ==="
          # 将URL列表转为JSON数组
          URL_LIST=$(jq -R -s -c 'split("\n") | map(select(length > 0))' valid_urls.txt)
          # 构造完整JSON请求体
          JSON_DATA=$(jq -n \
            --arg host "$INDEXNOW_HOST" \
            --arg key "$INDEXNOW_KEY" \
            --arg keyLocation "$INDEXNOW_KEY_LOCATION" \
            --argjson urlList "$URL_LIST" \
            '{host: $host, key: $key, keyLocation: $keyLocation, urlList: $urlList}')
          echo "✅ 请求数据构造完成（JSON）："
          echo "$JSON_DATA" | jq .  # 格式化输出JSON（便于调试）

          # ========== 4. 提交到Bing IndexNow API ==========
          echo -e "\n=== 提交到Bing IndexNow API ==="
          # 发送POST请求，捕获状态码和响应内容
          RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" -X POST \
            -H "Content-Type: application/json" \
            -d "$JSON_DATA" \
            "https://www.bing.com/indexnow?url=https://$INDEXNOW_HOST&key=$INDEXNOW_KEY")
          
          # 分离响应内容和HTTP状态码
          HTTP_STATUS=$(echo "$RESPONSE" | grep -oP 'HTTP_STATUS:\K\d+' | tail -1)
          API_RESPONSE=$(echo "$RESPONSE" | sed '/HTTP_STATUS:/d')

          # ========== 5. 结果判断与日志 ==========
          echo -e "\n=== 提交结果 ==="
          echo "HTTP状态码：$HTTP_STATUS"
          echo "API响应内容：$API_RESPONSE"

          # 成功条件：状态码200（成功）/202（接受待处理），或响应包含success/jobId
          if [[ $HTTP_STATUS =~ ^20[02]$ ]] || echo "$API_RESPONSE" | grep -qE '"success":true|"jobId"'; then
            echo -e "\n✅ 成功：$VALID_URL_COUNT 个URL已提交到Bing IndexNow"
          else
            echo -e "\n❌ 失败：提交失败（状态码：$HTTP_STATUS）"
            exit 1
          fi

编写工作流文件截图

测试与验证

1. 手动触发工作流：
   仓库 → 「Actions」→ 找到「Submit Blog URLs to Bing IndexNow」→ 「Run workflow」→ 点击「Run workflow」，查看运行日志（绿色对勾表示成功）；

手动触发工作流截图

2. 验证推送结果：
   登录Bing网站管理员工具，在「IndexNow」板块可查看提交记录和处理状态。

常见问题与优化建议

常见问题排查

1. Key验证失败：检查{key}.txt文件是否能访问、文件内容是否仅为Key、Key是否与Secrets中一致；
2. Sitemap解析失败：确认Sitemap地址可访问、URL格式为完整的https://开头、域名与配置的INDEXNOW_HOST一致；
3. HTTP状态码400/403：
   • 400：JSON格式错误（检查URL列表是否为空）；
   • 403：Key验证失败（重新检查Key文件）；
   • 429：请求频率超限。

优化建议

1. 限制推送频率：在on.push.paths中指定仅博客内容文件变更时触发，减少无效执行；
2. 拆分大批量URL：如果URL数量超过1000，可在代码中拆分批次提交；
3. 多搜索引擎适配：IndexNow协议支持多引擎，只需将API地址替换为对应引擎（如Yandex：https://yandex.com/indexnow）；

注意：在任意支持IndexNow的搜索引擎提交后，其它搜索引擎也可自动收录。

4. 增加失败重试：添加actions/github-script实现失败自动重试（最多3次）。

总结

通过GitHub Actions + IndexNow的组合，你实现了「博客内容更新→自动推送→搜索引擎快速收录」的全自动化流程，核心优势：

1. 无需手动操作，彻底解放双手；
2. 避免硬编码敏感信息，符合安全最佳实践；
3. 适配多种Sitemap格式，兼容性强；
4. 详细的日志输出，便于故障排查。

这套思路也可延伸到其他自动化场景（比如博客自动部署、图片压缩、链接检查），CI/CD的核心价值就是让重复的工作自动化，让你专注于内容创作而非繁琐的运维操作。