getAdvantage MCP Server

Xác thực

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

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

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

Giới hạn tốc độ

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

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

Điểm cuối kết hợp được tính là một lần gọi với cùng tốc độ mỗi công cụ (không bao giờ tính phí ba lần cho một lần 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 công cụ AI qua chín tín hiệu (tiêu đề, mô tả meta, dữ liệu có cấu trúc, tiêu đề, llms.txt, tỷ lệ nội dung/đánh dấu, Open Graph, canonical, robots). Trả về phân tích từng tín hiệu, các bản sửa sẵn sàng dán vào, và một tệp 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 + đọc nhanh 5 giây

Chấm điểm các tín hiệu quyết định liệu 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òn chạy bài kiểm tra ấn tượng đầu tiên tự động trong 5 giây. Trả về các kiểm tra, bản sửa, phần trăm chuẩn, và 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 triển khai + huy hiệu

Chạy các kiểm tra xác định cho các lỗ hổng phổ biến do lập trình vibe (bí mật trong gói client, cấu hình backend, tệp bị lộ, header bảo mật, CORS, transport, source maps). Kiểm tra đạt nghĩa là chúng tôi không tìm thấy vấn đề cụ thể đó — không có nghĩa ứng dụng an toàn hay được chứng nhận. Trả về các kiểm tra, bản sửa, phần trăm chuẩn, 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 công cụ, một lần gọi

Chạy cả ba công cụ trên một URL và trả về một payload: ba khối điểm độc lập (không bao giờ tính trung bình), một bản tóm tắt giao thoa nêu rõ khía cạnh yếu nhất và bước cải thiện lớn nhất tiếp theo, cùng một liên kết cố định. Cách nhanh nhất để có bức tranh 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ừ bên 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ó sử dụng Streamable HTTP từ xa (phương thức truyền tải từ xa chính thức hiện tại) — không cần cài đặt, các lầ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 với điểm số và bản sửa sẵn sàng dán vào lớn nhất, kèm theo 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 máy khách MCP của bạn:

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

Với khóa API (tốc độ cao hơn, đầu ra 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 ở tốc độ không khóa; khóa sẽ tăng tốc độ và trả về đầu ra trực tiếp, giống hệt API HTTP.

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

Hỏi Ray