HTTP · OAuth 2.0 · MCP

API Spytrend,
đang hoạt động.

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 ]

Từ con số 0 đến 200.

OAuth 2.0 client_credentials chuẩn. Ba lệnh gọi là xong.

01

Tự đăng ký một machine client

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"}'
02

Đổi lấy token

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'
03

Gọi tool

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 ]

Bắt đầu với những tool này.

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.

01toolsearch_ads

Tì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).

02toolget_trends

Xếp hạng theo GEO, nhà quảng cáo, webmaster, ứng dụng, timeline hoặc creative đang scale.

03toolsearch_webmasters

Mạng affiliate với khối lượng theo từng GEO và độ liên quan theo GEO chủ đạo.

04toolget_usage

Gói, đã dùng, còn lại. Kiểm tra miễn phí — gọi bao nhiêu lần tùy ý.

← về trang kết nốiOAuth 2.0 · client_credentials · RFC 8707