API và máy chủ MCP của Citevana

REST API

Mọi phản hồi đều ở dạng JSON. Phản hồi thành công có "ok": true. Các công cụ miễn phí trả về bản tóm tắt dễ hiểu và danh sách việc cần làm xếp theo mức độ quan trọng, kèm thời gian ước tính.

Ví dụ yêu cầu

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

Lỗi

Mọi lỗi đều dùng cùng cấu trúc JSON như bên dưới. Mã lỗi bao gồm invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited và quota_exceeded.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

Giới hạn và header

Mỗi phản hồi được tính hạn mức đều có X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset (giây Unix), mô tả hạn mức mà lượt gọi đó được tính vào. Phản hồi 429 còn có Retry-After. Lượt gọi không khóa được tính vào hạn mức công cụ miễn phí dùng chung của kết nối internet của bạn; lượt gọi có khóa được tính vào hạn mức api_calls hằng ngày của không gian làm việc, và mỗi khóa có thể có giới hạn hằng ngày riêng thấp hơn. Lượt gọi không trả về kết quả — vì không truy cập được trang web hoặc vì lớp chống bot đã trả lời thay — thì không bị tính.

Trình duyệt có thể gọi các endpoint công cụ miễn phí từ bất kỳ trang nào mà không cần khóa. Các endpoint cần khóa không cho phép yêu cầu trình duyệt khác nguồn gốc, vì vậy hãy gọi chúng từ máy chủ của bạn.

Thêm ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi hoặc ar vào endpoint công cụ để nhận bản tóm tắt bằng ngôn ngữ đó.

Nguồn, kiểm tra ngày 16 tháng 9, 2026: https://spec.openapis.org/oas/v3.1.1.html

Máy chủ MCP

Kết nối bất kỳ trình khách MCP nào hỗ trợ máy chủ từ xa tới https://citevana.com/api/mcp. Máy chủ dùng giao thức truyền tải Streamable HTTP, phản hồi bằng JSON và không lưu phiên.

• check_ai_crawlers — Trang web cho phép những crawler tìm kiếm, trợ lý và huấn luyện AI nào. Miễn phí.
• audit_page — Kiểm tra SEO on-page và mức sẵn sàng cho AI của một URL. Miễn phí.
• generate_llms_txt — Tạo tệp llms.txt từ tên trang, bản tóm tắt và các liên kết. Miễn phí; không tải dữ liệu nào.
• get_site_audit_summary — Lượt kiểm tra gần nhất của một trong các trang web của bạn. Cần khóa API có read:audits.

Máy chủ hỗ trợ bản sửa đổi giao thức 2026-07-28 (siêu dữ liệu theo từng yêu cầu và server/discover). Máy chủ cũng chấp nhận bắt tay initialize của các bản 2025-11-25, 2025-06-18 và 2025-03-26.

Ba công cụ miễn phí hoạt động không cần xác thực và dùng chung hạn mức không khóa là 3 lượt kiểm tra mỗi ngày cho mỗi kết nối internet. Với get_site_audit_summary, trình khách phải gửi khóa API trong header Authorization: Bearer, và điều đó cũng nâng hạn mức hằng ngày lên. Citevana hiện chưa hỗ trợ đăng nhập OAuth cho MCP.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Nguồn, kiểm tra ngày 16 tháng 9, 2026: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Trình khách MCP khác và agent của riêng bạn

Nếu trình khách cho phép đặt header HTTP cho máy chủ từ xa, hãy thêm Authorization: Bearer kèm khóa của bạn để dùng get_site_audit_summary. Lượt gọi có khóa được tính vào cùng hạn mức api_calls hằng ngày như REST API; không có khóa thì được tính vào hạn mức công cụ miễn phí dùng chung.

Tiện ích Chrome

Tiện ích Chrome của Citevana chạy kiểm tra crawler AI và kiểm tra trang trên tab bạn đang xem thông qua API này. Không cần tài khoản và tiện ích dùng hạn mức không khóa; khóa tùy chọn sẽ nâng giới hạn đó lên và hiển thị kết quả kiểm tra site của chính bạn. Tiện ích đang được chuẩn bị để phát hành trên Chrome Web Store.

Tiện ích chỉ yêu cầu quyền activeTab và storage, cùng quyền truy cập API của Citevana. Địa chỉ trang chỉ được gửi khi bạn nhấp kiểm tra, và chuỗi truy vấn không bao giờ được gửi.

Nguồn, kiểm tra ngày 16 tháng 9, 2026: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

An toàn và quyền riêng tư

• Mọi công cụ đều chỉ đọc. Không có gì trên trang web của bạn bị thay đổi.
• Văn bản sao chép từ các trang đã tải được đánh dấu là dữ liệu không đáng tin cậy, nên trợ lý AI không được làm theo chỉ dẫn trong đó.
• Chúng tôi chỉ tải các trang công khai dưới tên CitevanaBot, và chặn các địa chỉ mạng riêng và dành riêng.
• Chúng tôi chỉ lưu giá trị băm SHA-256 của mỗi khóa API. Khóa chỉ hiển thị một lần và bạn có thể thu hồi bất cứ lúc nào. Việc tạo và thu hồi khóa được ghi vào nhật ký kiểm tra.

CitevanaBot

Câu hỏi thường gặp

Nguồn

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies