IndexNow cho Bing và Yandex trong Next.js: khóa, gửi URL và lý do Google không có trong danh sách
Những gì IndexNow làm và không làm
IndexNow là một giao thức mở mà qua đó một trang web sẽ thông báo cho các công cụ tìm kiếm “những địa chỉ này đã được thêm, thay đổi hoặc xóa”. Nó được hỗ trợ bởi Bing, Yandex và một số công cụ tìm kiếm khác; một thông báo được gửi đến một người tham gia sẽ được truyền đến những người khác.
Giao thức không làm gì:
- Không đảm bảo lập chỉ mục. Công cụ tìm kiếm tìm hiểu về trang nhanh hơn nhưng quyết định lập chỉ mục và thời gian xuất hiện trong kết quả vẫn thuộc về nó.
- Không hoạt động với Google. Google không tham gia IndexNow. Đối với anh ấy, tín hiệu chính là sơ đồ trang web có ngày chính xác
lastmodvà các liên kết nội bộ. API lập chỉ mục của Google chỉ dành cho các trang có vị trí tuyển dụng và chương trình phát sóng; nó không thể được sử dụng cho các bài viết.
Chìa khóa
Khóa là một chuỗi từ 8 đến 128 ký tự gồm chữ cái Latinh, số và dấu gạch nối. Tạo nó một lần:
node -e "console.log(crypto.randomUUID().replaceAll('-', ''))"Công cụ tìm kiếm xác minh rằng khóa thuộc về trang web bằng cách tải tệp có khóa. Tùy chọn đơn giản nhất là tệp public/<ключ>.txt, nội dung của chúng là cùng một khóa. Nó sẽ có sẵn tại https://example.com/<ключ>.txt.
Khóa không phải là bí mật: theo định nghĩa, nó nằm trong một tệp công khai, do đó việc lưu trữ nó trong kho lưu trữ là điều bình thường. Xác nhận quyền sở hữu được cung cấp không phải bởi bí mật của khóa mà bởi thực tế là chỉ chủ sở hữu tên miền mới có thể đặt tệp với nó.
Có thể đặt tệp ở một vị trí khác bằng cách chỉ định tệp đó trong tham số keyLocation. Xem xét giới hạn giao thức: vị trí của tệp xác định phạm vi của khóa. Khóa từ https://example.com/blog/<ключ>.txt chỉ xác thực các địa chỉ bắt đầu bằng https://example.com/blog/. Để bao quát toàn bộ trang web, tệp phải ở thư mục gốc.
Kiểm tra sau khi triển khai:
curl -i https://example.com/$INDEXNOW_KEY.txt # HTTP/2 200, тело — ровно ключ, без редиректов
Công văn
// lib/indexnow.ts
const ENDPOINT = "https://api.indexnow.org/indexnow";
export async function submitToIndexNow(urls: string[]) {
if (urls.length === 0) return;
const host = new URL(urls[0]).host;
for (let i = 0; i < urls.length; i += 10_000) {
const batch = urls.slice(i, i + 10_000);
const res = await fetch(ENDPOINT, {
method: "POST",
headers: { "Content-Type": "application/json; charset=utf-8" },
body: JSON.stringify({
host,
key: process.env.INDEXNOW_KEY,
keyLocation: `https://${host}/${process.env.INDEXNOW_KEY}.txt`,
urlList: batch,
}),
});
if (res.status !== 200 && res.status !== 202) {
throw new Error(`IndexNow ${res.status}: ${await res.text()}`);
}
}
}Tất cả URL trong một yêu cầu phải thuộc về máy chủ lưu trữ trong trường host. Thay vì địa chỉ chung, api.indexnow.org có thể được gửi trực tiếp đến https://www.bing.com/indexnow hoặc https://yandex.com/indexnow - kết quả được phân bổ giữa những người tham gia trong mọi trường hợp nên không cần gửi đến nhiều điểm cùng lúc.
Mã phản hồi
| Mã | Ý nghĩa | Phải làm gì | |---|---|---| | 200 | Đã chấp nhận | Không có gì | | 202 | Đã chấp nhận, key vẫn đang được xác minh | Không có gì, kiểm tra không đồng bộ | | 400 | Định dạng không hợp lệ | Kiểm tra tiêu đề JSON và Content-Type | | 403 | Chìa khóa chưa được xác nhận | Mở file key trên trình duyệt, kiểm tra nội dung | | 422 | URL không thuộc về máy chủ hoặc khóa không khớp | Kiểm tra tên miền, www và giao thức | | 429 | Quá nhiều yêu cầu | Gửi ít thường xuyên hơn, URL nhóm |
Khi nào nên gọi
Gửi thông báo khi một trang được xuất bản hoặc thực hiện thay đổi đáng kể, thay vì theo lịch trình trên toàn trang web:
// app/admin/actions.ts
"use server";
import { revalidatePath } from "next/cache";
import { after } from "next/server";
import { submitToIndexNow } from "@/lib/indexnow";
export async function publishPost(slug: string) {
await db.post.update({ where: { slug }, data: { status: "published", publishedAt: new Date() } });
revalidatePath(`/blog/${slug}`);
after(() => submitToIndexNow([`https://example.com/blog/${slug}`]).catch(console.error));
}after từ next/server (ổn định kể từ Next.js 15.1) sẽ đăng sau khi người dùng phản hồi, do đó, sự cố IndexNow không ngăn cản việc xuất bản. Thứ tự rất quan trọng: đầu tiên trang phải có thể truy cập được và trả về 200, sau đó là thông báo. Nếu công cụ tìm kiếm đến trước khi quá trình xác nhận lại hoàn tất, nó sẽ thấy phiên bản cũ.
Các lỗi thường gặp
- Gửi tất cả các URL trang web với mỗi lần triển khai. Giao thức có thể thay đổi; việc gửi lại hàng loạt các trang không thay đổi không tăng tốc độ lập chỉ mục và có thể dẫn đến những hạn chế.
- Khóa nằm trong
public, nhưng trang web cung cấp nó với chuyển hướng từexample.comđếnwww.example.comvàhostđược chỉ định mà không cówww. - Thông báo về một trang từ
noindexhoặc từ địa chỉ chuẩn đến một địa chỉ khác - công cụ tìm kiếm sẽ đến và không lập chỉ mục trang đó. - Kỳ vọng rằng sau IndexNow trang sẽ xuất hiện trên Google.
Song song làm gì cho Google
Đảm bảo rằng sitemap.xml chỉ liệt kê các địa chỉ có thể lập chỉ mục chuẩn và lastmod chỉ thay đổi khi nội dung thực sự thay đổi chứ không phải trên mọi bản dựng. Gửi sơ đồ trang web của bạn tới Search Console. Đối với các trang quan trọng mới, bạn có thể yêu cầu lập chỉ mục theo cách thủ công thông qua kiểm tra URL - đây là công cụ thủ công, không phải API để sử dụng hàng loạt.
Khi IndexNow không hoạt động
Nếu trang web xuất bản một số bài viết mỗi tháng và Bing và Yandex thường xuyên bỏ qua nó, thì sự khác biệt sẽ không đáng chú ý. Giao thức này hữu ích hơn cho các trang web có thay đổi thường xuyên: tin tức, danh mục có giá cả và tình trạng sẵn có thay đổi, diễn đàn.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.