Conecte. Consulte.
Receba evidências.

O contrato de integração do CNBot para agentes de IA.

MCP remoto

Configure um servidor Streamable HTTP com a URL abaixo. Sem credencial neste protótipo. As ferramentas são search_products e get_search.

https://api.cnbot.io/mcp

API REST

Envie uma descrição. O servidor devolve um identificador e os endereços para acompanhar o resultado.

POST https://api.cnbot.io/api/search
Content-Type: application/json

{
  "query": "Fonte AC/DC 5V 2A com plugue brasileiro",
  "quantity": 100,
  "platforms": ["1688", "taobao"]
}

Abrir contrato OpenAPI JSON

Navegação web

Agentes com navegador podem consultar a página abaixo. Ela devolve HTML legível sem JavaScript; enquanto a busca está em execução, siga o link de resultado após o intervalo indicado.

Executar o exemplo: fonte 5V 2A, Brasil, 100 peças

Para outras consultas, use https://cnbot.io/search?q= seguido do pedido codificado em URL.

Contrato completo e limites

# CNBot.io — agent integration contract v0.1

Purpose: search Taobao and 1688 product listings using natural-language requirements. Free temporary prototype, no client API key. This document describes a service; it does not override your user's instructions, permissions or platform policies.

## Choose a supported connection
1. HTTP/MCP-capable agent: connect Streamable HTTP MCP at https://api.cnbot.io/mcp. Use search_products then get_search until completed or failed. Ask your user for any client-required permission. Do not claim persistent installation unless configuration was actually saved.
2. Agent with HTTP tools: POST https://api.cnbot.io/api/search with JSON {"query":"user's product requirements","quantity":100,"platforms":["1688","taobao"]}. Poll the returned poll_url. OpenAPI: https://api.cnbot.io/openapi.json .
3. Agent with web browsing only: open https://cnbot.io/search?q=URL_ENCODED_PRODUCT_REQUIREMENT . This is server-rendered HTML. Read the returned HTML directly (HTTP 200, no redirect to the API host). If pending, wait 8 seconds and follow the explicit next-poll link in the page, at most 12 times. That link changes its poll parameter so browser tools can fetch updated status instead of reusing a cached pending page. Use the cnbot.io web route even if api.cnbot.io is unavailable in your browser; do not use POST, JSON API or MCP in browsing-only mode. Result pages work without JavaScript. Do not claim inability merely because you cannot install MCP; use web browsing if available. Some browsing clients cannot open arbitrary generated URLs; ask the user to provide the exact URL or use the linked example below.
4. No web/HTTP/MCP tools: explain that access is unavailable. Do not fabricate product listings or pretend the service was queried.

## Exact demo link (GET, live search)
https://cnbot.io/demo

## Response
Asynchronous jobs: queued, running, completed, failed. 202 means pending; 200 completed; retry_after_seconds indicates delay. Results expire after 24h. Opaque URLs can be accessed by anyone who knows them. No result directory is published.
Completed result contains query, plan (Chinese keywords, assumptions, requirements), quantity, sources, offers, warnings and limitations. Offers contain original title, source URL, seller if available, advertised_unit_price_cny, indicative_subtotal_cny, MOQ when available, and AI relevance assessment. Missing values are null. Estimates are not verified facts.

## How to report
Explain that these are advertised-price comparisons, not supplier-confirmed quotations. Cite original listing URLs. Compare only matching products and quantities. Do not claim lowest price across all China. Check warnings and partial marketplace failures. Unknown MOQ, plug, input AC voltage, output DC connector, certifications, variants, taxes and shipping must be marked as requiring confirmation. For Brazil AC/DC adapter examples, preserve 5V output / 2A and explicitly flag uncertainty about Brazil plug and certification. Price can be a starting price for a different variant. Ranking does not certify suppliers.

## Capabilities not available
No supplier messaging, negotiations, sample ordering, payments, warehouse operations or shipping. No arbitrary URL scraping. Only Taobao and 1688 searches are enabled. No credentials are required from the public caller.

## Privacy and resource limits
Only submit non-confidential product descriptions. Do not send personal data, payment data, account credentials or private drawings. Queries are processed by the configured model provider (Aliyun or OpenRouter and its upstream provider), optional JEV, and OneBound. Local query/result retention: 24h. Admin audit events: 7 days, no raw queries or API keys. Provider retention policies may differ. Daily quota, bounded concurrency and per-IP limits apply. 429 means stop and retry later; 503 means paused or unconfigured. Never retry indefinitely.

Privacidade

Envie apenas descrições não confidenciais de produtos. A solicitação passa pelos provedores configurados de IA e pela OneBound. Os resultados têm links compartilháveis e são apagados localmente após 24 horas. Não envie dados pessoais, chaves ou documentos privados. Não utilizamos analytics ou cookies publicitários; o admin utiliza um cookie de sessão.