1429 字

4 分钟

使用 IndexNow API 自动推送网站更新到搜索引擎

2026-02-21

技术教程

SEO

/

IndexNow

/

Python

/

Bing

/

搜索引擎优化

使用 IndexNow API 自动推送网站更新到搜索引擎#

对于运营网站的朋友来说，最头疼的事情之一就是：辛辛苦苦写了一篇新文章，搜索引擎却迟迟不来收录。IndexNow 正是为了解决这个问题而生——它让你可以主动告诉搜索引擎”我的网站有更新了，快来抓取吧”。

本文将详细介绍如何使用 Python 脚本实现全自动的 IndexNow 推送，让你的新内容能被搜索引擎快速发现并收录。

什么是 IndexNow#

IndexNow 是一项开放的协议，允许网站所有者通过简单的 API 调用，即时通知搜索引擎网站内容的变更。目前支持 IndexNow 的主要搜索引擎包括：

Bing（微软必应）
Yandex（俄罗斯搜索引擎）
Seznam.cz（捷克搜索引擎）

IndexNow 的核心优势#

相比传统的等待搜索引擎爬虫被动发现，IndexNow 带来了显著的优势：

特性	传统方式	IndexNow
收录速度	数天至数周	几分钟到几小时
主动性	被动等待	主动通知
资源消耗	频繁爬取	按需抓取
配置难度	简单	中等

实际效果：在本站启用 IndexNow 后，新发布的文章通常在 10-30 分钟内就能在 Bing 搜索中被检索到，收录速度提升了数十倍。

前置准备工作#

在开始编写推送脚本之前，你需要完成以下准备工作：

1. 申请 IndexNow API 密钥#

访问 Bing 网站管理员工具或 IndexNow 官网生成你的专属 API 密钥。

密钥生成后，需要将其放置在网站根目录下：

创建一个文本文件，文件名就是密钥本身（例如：5474f3826c5b4b9ea03c15dcee108f7c.txt）
文件内容也填写相同的密钥
上传到网站的根目录，确保可以通过 https://你的域名/密钥.txt 访问

验证方法：在浏览器中访问 https://your-domain.com/your-key.txt，应该能看到纯文本的密钥内容。

2. 确认站点地图可访问#

确保你的网站已经生成了标准的 XML 格式站点地图（sitemap），并且可以通过 URL 直接访问，例如：

1
https://www.yourdomain.com/sitemap-0.xml
2
https://www.yourdomain.com/sitemap.xml

编写推送脚本#

下面是一个完整的 Python 脚本，它会自动抓取你的站点地图，并将所有 URL 逐个推送到 IndexNow。

完整代码实现#

1
import requests
2
import xml.etree.ElementTree as ET
3
import json
4
import time
5

6
# --- 配置区域 ---
7
# 你的站点地图 URL
8
SITEMAP_URL = "https://www.yourdomain.com/sitemap-0.xml"
9

10
# 你的 IndexNow API 密钥
11
INDEXNOW_API_KEY = "your_api_key_here"
12

13
# 你的网站域名
14
HOST = "www.yourdomain.com"
15

16
# IndexNow API 端点
17
INDEXNOW_API_URL = "https://api.indexnow.org/indexnow"
18

19

20
def fetch_and_parse_sitemap():
21
    """获取并解析站点地图，提取所有 URL。"""
22
    print(f"正在获取站点地图: {SITEMAP_URL}")
23

24
    try:
25
        response = requests.get(SITEMAP_URL, timeout=10)
26
        response.raise_for_status()
27
    except requests.exceptions.RequestException as e:
28
        print(f"获取站点地图失败: {e}")
29
        return []
30

31
    print("站点地图获取成功，正在解析 URL...")
32

33
    try:
34
        # 注册 XML 命名空间
35
        namespaces = {'sm': 'http://www.sitemaps.org/schemas/sitemap/0.9'}
36
        root = ET.fromstring(response.content)
37

38
        # 提取所有 <loc> 标签中的 URL
39
        urls = [elem.text for elem in root.findall('sm:url/sm:loc', namespaces)]
40
        return urls
41
    except ET.ParseError as e:
42
        print(f"解析 XML 时出错: {e}")
43
        return []
44

45

46
def submit_to_indexnow(url_list):
47
    """将 URL 列表提交到 IndexNow API。"""
48
    if not url_list:
49
        print("没有需要提交的 URL。")
50
        return
51

52
    key_location = f"https://{HOST}/{INDEXNOW_API_KEY}.txt"
53

54
    payload = {
55
        "host": HOST,
56
        "key": INDEXNOW_API_KEY,
57
        "keyLocation": key_location,
58
        "urlList": url_list
59
    }
60

61
    headers = {
62
        'Content-Type': 'application/json; charset=utf-8'
63
    }
64

65
    print(f"正在提交: {url_list[0]}")
66

67
    try:
68
        response = requests.post(
69
            INDEXNOW_API_URL,
70
            headers=headers,
71
            data=json.dumps(payload),
72
            timeout=10
73
        )
74

75
        # IndexNow 返回 200 或 202 都表示成功
76
        if response.status_code in [200, 202]:
77
            print(f"✅ 提交成功 (状态码: {response.status_code})")
78
        else:
79
            print(f"❌ 提交失败 (状态码: {response.status_code})")
80
            print(f"响应内容: {response.text}")
81

82
    except requests.exceptions.RequestException as e:
83
        print(f"请求异常: {e}")
84

85

86
if __name__ == "__main__":
87
    urls_to_submit = fetch_and_parse_sitemap()
88

89
    if urls_to_submit:
90
        print(f"\n共发现 {len(urls_to_submit)} 个 URL，开始推送...\n")
91

92
        for i, url in enumerate(urls_to_submit, 1):
93
            print(f"[{i}/{len(urls_to_submit)}] ", end="")
94
            submit_to_indexnow([url])
95
            # 添加延迟，避免请求过于频繁
96
            time.sleep(0.5)
97

98
        print("\n✨ 所有 URL 推送完成！")
99
    else:
100
        print("未能从站点地图中获取任何 URL。")

代码关键解析#

站点地图解析：

1
namespaces = {'sm': 'http://www.sitemaps.org/schemas/sitemap/0.9'}
2
urls = [elem.text for elem in root.findall('sm:url/sm:loc', namespaces)]

站点地图使用 XML 命名空间，需要正确注册才能解析到 URL。

API 请求结构：

1
payload = {
2
    "host": HOST,
3
    "key": INDEXNOW_API_KEY,
4
    "keyLocation": key_location,
5
    "urlList": url_list
6
}

IndexNow 要求同时提供密钥和密钥文件的访问地址，用于验证你对网站的所有权。

使用步骤#

第一步：安装依赖#

确保你的环境中已安装 requests 库：

1
pip install requests

第二步：修改配置#

打开脚本，修改以下三个配置项：

配置项	说明	示例值
`SITEMAP_URL`	你的站点地图完整 URL	`https://example.com/sitemap.xml`
`INDEXNOW_API_KEY`	从 Bing 获取的 API 密钥	`a1b2c3d4e5f6...`
`HOST`	你的域名（不含协议）	`www.example.com`

第三步：运行脚本#

1
python indexnow_pusher.py

运行后你会看到类似这样的输出：

1
正在获取站点地图: https://www.example.com/sitemap-0.xml
2
站点地图获取成功，正在解析 URL...
3

4
共发现 25 个 URL，开始推送...
5

6
[1/25] 正在提交: https://www.example.com/post-1
7
✅ 提交成功 (状态码: 200)
8
[2/25] 正在提交: https://www.example.com/post-2
9
✅ 提交成功 (状态码: 200)
10
...
11
✨ 所有 URL 推送完成！

进阶：集成到 CI/CD 流程#

如果你使用 GitHub Actions 或类似的 CI/CD 工具，可以在每次部署后自动执行推送脚本。以下是一个 GitHub Actions 工作流示例：

1
name: Push to IndexNow
2

3
on:
4
  push:
5
    branches: [main]
6

7
jobs:
8
  indexnow:
9
    runs-on: ubuntu-latest
10
    steps:
11
      - uses: actions/checkout@v4
12

13
      - name: Setup Python
14
        uses: actions/setup-python@v5
15
        with:
16
          python-version: '3.11'
17

18
      - name: Install dependencies
19
        run: pip install requests
20

21
      - name: Push to IndexNow
22
        run: python scripts/indexnow_pusher.py

这样，每次你推送代码到主分支时，站点地图中的 URL 都会自动推送给搜索引擎。

常见问题#

Q: 为什么推送成功了，但文章还是没有被收录？#

IndexNow 只是通知搜索引擎”这里有新内容”，但具体何时抓取和收录仍由搜索引擎决定。通常几分钟到几小时内会看到效果，如果内容质量不佳，也可能不被收录。

Q: 每次推送有数量限制吗？#

IndexNow 官方建议单次推送不超过 10,000 个 URL。对于普通博客站点，通常不会有这个问题。

Q: 可以频繁推送吗？#

虽然技术上可以，但建议只在有实质性内容更新时推送。过于频繁的无效推送可能导致 API 被限制。

Q: 密钥文件必须放在根目录吗？#

是的，IndexNow 协议要求密钥文件必须放在域名根目录，以便搜索引擎验证网站所有权。

Q: Google 支持 IndexNow 吗？#

目前 Google 尚未正式支持 IndexNow 协议。对于 Google，建议同时使用传统的 Sitemap 提交方式。

总结#

通过本文，你已经学会了：

了解 IndexNow 的工作原理 —— 主动通知搜索引擎内容更新的开放协议
申请和配置 API 密钥 —— 完成网站所有权验证
编写 Python 推送脚本 —— 自动化站点地图解析和 URL 推送
集成到部署流程 —— 实现全自动化的 SEO 优化

IndexNow 是提升网站 SEO 效果的有力工具，特别适合内容更新频繁的博客和资讯类网站。将它集成到你的发布流程中，可以显著缩短新内容的收录时间，让更多读者通过搜索引擎发现你的优质内容。

如果你在配置过程中遇到问题，或者有任何 SEO 优化的心得，欢迎在评论区留言交流。如果觉得本文有帮助，别忘了分享给需要的朋友！

使用 IndexNow API 自动推送网站更新到搜索引擎

https://www.freebird2913.tech/posts/index_now/

作者

freebird2913

发布于

2026-02-21

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

Netlify 自定义域名添加 SSL 证书开启 HTTPS 完整指南

元旦快乐：2026年新年贺词