# DigSQL Agent API

## Read (no auth)
- GET http://digsql.com/api/agent/products — product index (JSON)
- GET http://digsql.com/api/agent/products/{slug} — detail + cross-region prices (JSON)

## Submit a channel price (auth)

Create a personal API token at your account page, then send it as the
`x-api-key` request header.

POST http://digsql.com/api/agent/prices
Content-Type: application/json
x-api-key: <your token>

Body:
  { "slug": "<product slug>", "channel": "taobao", "amount": 7800,
    "observedOn": "YYYY-MM-DD", "version": "CN", "note": "...",
    "promoTags": ["national_subsidy"], "promoAmount": 500 }

channel ∈ jd|taobao|tmall|pdd|official|daigou|offline|other;
version ∈ CN|HK|US|JP (optional); amount is CNY; observedOn is YYYY-MM-DD.
Submissions enter the same human moderation queue as web submissions.

Responses: 200 {ok,id,status:'pending'} | 401 missing/invalid api key |
404 not_found (unknown slug) | 400 invalid_body | 429 rate_limited.

## MCP
Streamable-HTTP MCP endpoint: POST http://digsql.com/api/mcp (JSON-RPC 2.0).
Read/contribution tools: search_products, get_product_prices, submit_channel_price.
Pass your token via x-api-key or Authorization: Bearer for submit.

Admin tools (Authorization: Bearer <ADMIN_API_TOKEN>):
admin_list_brands, admin_upsert_brand, admin_delete_brand,
admin_list_events, admin_upsert_event, admin_delete_event,
admin_list_rumored_products, admin_upsert_rumored_product, admin_delete_rumored_product,
admin_upsert_product, admin_patch_product_prices, admin_delete_product_price,
admin_patch_product_specs, admin_patch_ai_conclusion, admin_patch_product_summary, admin_set_product_flag, admin_set_predecessor,
admin_delete_product. Destructive/replacing tools require confirm=true.

Direct admin HTTP for AI/editor verdicts:
PATCH http://digsql.com/api/admin/products/{slug}/ai-conclusion
Authorization: Bearer <ADMIN_API_TOKEN>
Content-Type: application/json
Body: { "zh": "AI 结论...", "en": "AI verdict..." }