getAdvantage MCP

Tài liệu API & MCP

Chạy ba bản quét Advantage từ mã của bạn, từ CI, hoặc từ ngay trong trình soạn thảo AI. Get Found đo cách AI đọc một URL trực tiếp. Convert đo xem một khách truy cập lần đầu có đăng ký hay không. Ship Verified kiểm tra những gì trang đã phát hành mà lẽ ra không nên có. Mọi kết quả đều là phép đo quan sát được tại thời điểm quét — không bao giờ là phán quyết, chứng nhận, hay cam kết.

API miễn phí để dùng thử không cần khóa ở mức giới hạn theo IP. Một khóa API nâng giới hạn lên theo gói của bạn và trả về kết quả mô hình trực tiếp trên gói trả phí. Đặc tả máy đọc được nằm tại /api/openapi.json.

Vì sao nên tích hợp một lần? Để bạn không phải tự duy trì AEO bằng tay. Nhúng đoạn mã hoặc một lệnh gọi API vào CI của bạn và các bản sửa an toàn với DOM (JSON-LD, meta, FAQ) sẽ tự động được áp dụng; chúng tôi kiểm tra lại khi ChatGPT, Perplexity, Gemini & Claude thay đổi cách họ đọc trang web, để điểm số của bạn luôn cập nhật mà không cần bạn phải đuổi theo mục tiêu. Một công cụ trung lập liên tục theo dõi khả năng hiển thị với AI và an toàn khi phát hành — giám sát độc lập, không phải kiểm toán một lần. (llms.txt và robots.txt của bạn vẫn là các tệp bạn đặt một lần.)

Xác thực

Tạo khóa tại /app/api-keys (chỉ hiển thị một lần — hãy lưu nó như một bí mật môi trường, không bao giờ commit nó). Gửi nó như một token Bearer trong mọi yêu cầu:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

Không có header, bạn nhận được gói miễn phí không cần khóa (giới hạn theo IP, kết quả lấy mẫu). Có khóa, giới hạn theo gói của bạn và gói trả phí trả về kết quả mô hình trực tiếp. Vượt giới hạn trả về HTTP 429 với header retry-after; khóa không hợp lệ trả về 401.

Giới hạn tốc độ

Giới hạn được quan sát theo từng khóa (hoặc theo IP, không cần khóa) tại thời điểm yêu cầu:

• Không cần khóa: 5/phút · 30/ngày, kết quả lấy mẫu
• Starter: 60/phút · 1.000/ngày, kết quả trực tiếp
• Pro: 120/phút · 5.000/ngày, kết quả trực tiếp
• Agency: 240/phút · 20.000/ngày (sử dụng hợp lý), kết quả trực tiếp

Điểm cuối kết hợp tính là một lần đếm ở cùng mức giới hạn theo từng engine (không bao giờ tính phí ba lần cho một lệnh gọi).

Điểm cuối

GET /api/analyze?url=

Get Found — Quét khả năng đọc của AI (9 tín hiệu)

Chấm điểm mức độ dễ đọc của trang đối với các engine AI qua chín tín hiệu (tiêu đề, mô tả meta, dữ liệu có cấu trúc, tiêu đề mục, llms.txt, tỷ lệ nội dung trên markup, Open Graph, canonical, robots). Trả về phân tích chi tiết theo từng tín hiệu, các bản sửa sẵn sàng dán, và một llms.txt khởi đầu được tạo sẵn.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — Mức sẵn sàng chuyển đổi + bài đọc nhanh 5 giây

Chấm điểm các tín hiệu quyết định liệu một khách truy cập lần đầu có hiểu ứng dụng và đăng ký hay không. Với khóa trả phí, nó cũng chạy bài kiểm tra ấn tượng đầu tiên 5 giây dạng agentic. Trả về các kiểm tra, bản sửa, phân vị chuẩn, và một báo cáo /v có thể chia sẻ.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — Kiểm tra an toàn khi phát hành + huy hiệu

Chạy các kiểm tra xác định cho các lỗ hổng phổ biến kiểu vibe-coding (bí mật trong bundle client, cấu hình backend, tệp bị lộ, header bảo mật, CORS, truyền tải, source maps). Một kiểm tra đạt nghĩa là chúng tôi không tìm thấy vấn đề cụ thể đó — không bao giờ có nghĩa là ứng dụng an toàn hoặc được chứng nhận. Trả về các kiểm tra, bản sửa, phân vị chuẩn, một báo cáo /v, và huy hiệu “Checked by Advantage”.

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combined — cả ba engine, một lệnh gọi

Chạy cả ba engine trên một URL và trả về một payload: ba khối điểm độc lập (không bao giờ lấy trung bình), một bản tóm tắt giao nhau nêu rõ chiều yếu nhất và bước tiếp theo lớn nhất duy nhất, và một permalink. Cách nhanh nhất để có toàn cảnh trong một yêu cầu duy nhất.

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

Máy chủ MCP — quét từ ngay trong trình soạn thảo của bạn

Advantage cũng là một máy chủ Model Context Protocol, vì vậy bạn có thể thêm nó một lần vào Claude Code, Cursor, Claude Desktop, hoặc Windsurf và chỉ cần gõ “scan my app with getadvantage”. Nó nói chuyện qua remote Streamable HTTP (giao thức remote chính thức hiện tại) — không cần cài đặt, các bản quét chạy trên máy chủ của chúng tôi. Nó cung cấp bốn công cụ: get_found, convert_check, ship_verified, và combined_scan. Mỗi công cụ dẫn đầu bằng điểm số và bản sửa sẵn sàng dán lớn nhất, và bao gồm liên kết báo cáo.

Thêm nó (Cursor / Claude Desktop / Claude Code)

Thả đoạn này vào cấu hình MCP client của bạn:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

Với khóa API (giới hạn cao hơn, kết quả trực tiếp), thêm header:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

Hoặc, trong Claude Code, một dòng:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

Máy chủ MCP miễn phí để dùng thử không cần khóa ở mức không cần khóa; một khóa nâng giới hạn và trả về kết quả trực tiếp, giống hệt như HTTP API.

Muốn theo dõi các trang web, xem lịch sử, và tự động áp dụng bản sửa qua đoạn nhúng? Tạo tài khoản — hoặc quét một ứng dụng miễn phí trước.