HTTP · OAuth 2.0 · MCP
Cùng 22 tool đó, qua HTTP thuần. Tự đăng ký một machine client, lấy token, gọi tool. Không cần SDK — mặc dù SDK MCP chính thức giúp chỉ cần một dòng import.
[ BẮT ĐẦU NHANH ]
OAuth 2.0 client_credentials chuẩn. Ba lệnh gọi là xong.
Một request POST đến /oauth2/register — không cần người, trình duyệt hay email. Bạn sẽ nhận lại client_id và client_secret.
curl -X POST https://mcp.spytrend.com/oauth2/register \
-H 'Content-Type: application/json' \
-d '{"client_name":"my-agent","grant_types":["client_credentials"],
"response_types":[],"token_endpoint_auth_method":"client_secret_basic",
"scope":"mcp:read"}'Grant client_credentials với HTTP Basic auth. Token sống khoảng 1 giờ; làm mới bằng cách gọi lại.
curl -X POST https://mcp.spytrend.com/oauth2/token \ -u "$CLIENT_ID:$CLIENT_SECRET" \ -d 'grant_type=client_credentials&scope=mcp:read&audience=https://mcp.spytrend.com/mcp'
JSON-RPC tools/call đến endpoint MCP bằng Bearer token của bạn. Mọi tool trong danh mục ở trên.
curl -X POST https://mcp.spytrend.com/mcp \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_ads","arguments":{"country":"BR","limit":5}}}'Machine client chưa có tài khoản sẽ bắt đầu với một pool chung 500 token cho mỗi mạng nguồn (/24): 1 token cho mỗi dòng được trả về; media quảng cáo 1, media creative 10, quảng cáo đa ngôn ngữ 50, dòng TikTok 10. Giá được nhân với số bộ lọc trong yêu cầu (tối thiểu 1). Trước một lệnh gọi tốn phí, tool miễn phí estimate_cost sẽ cho agent biết sẽ tốn bao nhiêu token.
[ CÁC CÔNG CỤ CHÍNH ]
Danh mục đầy đủ nằm trên trang kết nối. Đây là những tool mà hầu hết các team tích hợp trước tiên.
search_adsTìm kiếm quảng cáo có lọc: GEO, vertical, trạng thái, domain landing, ngày. 1 token cho mỗi quảng cáo trả về (trang mặc định 20).
get_trendsXếp hạng theo GEO, nhà quảng cáo, webmaster, ứng dụng, timeline hoặc creative đang scale.
search_webmastersMạng affiliate với khối lượng theo từng GEO và độ liên quan theo GEO chủ đạo.
get_usageGói, đã dùng, còn lại. Kiểm tra miễn phí — gọi bao nhiêu lần tùy ý.