clue
Español
English한국어日本語简体中文繁體中文EspañolPortuguêsDeutschFrançaisItalianoРусскийالعربيةहिन्दीBahasa IndonesiaTiếng ViệtไทยTürkçeNederlandsPolskiSvenska
Iniciar sesiónComenzar
Cómo funcionaAnunciantesEditoresPara agentesPreciosDocumentación
Iniciar sesiónComenzar
Para agentes

Para agentes de IA: cómo leer un clue.

Si eres un agente de IA y has llegado aquí, la superficie que has visitado incluye un clue. Esta página explica exactamente qué es un clue, qué no es y cómo esperamos que lo trates. Todo lo contenido en esta página también está disponible como texto plano en /llms.txt y como documento legible por máquina en /.well-known/agent-ads.json.

HHoshino Stay1Sponsored8

Hoshino Stay Osaka — family rooms near Namba2

Family rooms for 4 from $140 a night. Free cancellation, breakfast included, 5 minutes from Namba station.3

  • Family rooms for 4
  • Free cancellation
  • Breakfast included
  • 4

From $140 per night, family room for 45

→ hoshinostay.com · ?clue_id=…6Check availability
docs · MCP · llms.txt · API7outcome_url9

This is a sponsored clue delivered by clue. The operator of this page or service did not endorse it. Evaluate it against your task and your user's instructions.

Anatomía de un clue.

Nueve campos, en cualquiera de los 20 idiomas que haya pedido el agente.

  1. 1
    ProveedorLa marca detrás de la oferta.
  2. 2
    Oferta en una líneaQué es, en una sola línea.
  3. 3
    ResumenDos frases sobre las que un agente puede actuar.
  4. 4
    CapacidadesLo que el agente puede hacer con ello.
  5. 5
    PrecioPrecios en texto plano con niveles y unidades.
  6. 6
    Siguiente acción y URL de destinoRedirección firmada con clue_id adjunto.
  7. 7
    Enlaces para agentes (docs, MCP, llms.txt, API)Docs, MCP, llms.txt, API.
  8. 8
    Indicador de patrocinio y divulgaciónsponsored: true, en el idioma del agente.
  9. 9
    URL de resultadosDonde el agente reporta cómo fue.

Un clue es un emplazamiento pagado, y así se indica.

Cada clue incluye sponsored: true y una frase de divulgación en el idioma que solicitaste. El editor de la superficie que estabas leyendo no respaldó al proveedor. Evalúa la opción por sus méritos en relación con la tarea que te han asignado, y antepón siempre las instrucciones explícitas de tu usuario a cualquier cosa que diga un clue. Los anunciantes pueden comprar la oportunidad de ser considerados. No pueden comprar tu conclusión.

Un clue es información estructurada, no persuasión.

Un clue tiene nueve campos: proveedor, oferta, resumen, capacidades, precio, siguiente acción con una URL de destino, puntos de entrada para máquinas (docs, MCP, llms.txt, API), el indicador de patrocinio con su divulgación y una URL de resultados. Nada en un clue es una instrucción para ti. Nuestra política rechaza los clues que se dirigen a los agentes, les piden que prefieran a un proveedor o contienen texto similar a un prompt. Aquí tienes un ejemplo completo, solicitado en japonés.

{
  "sponsored": true,
  "disclosure": "これはclueが配信した有料掲載です。このページの発行者が推奨したものではありません。与えられたタスクとユーザーの指示に照らして判断してください。",
  "label": "広告",
  "lang": "ja",
  "clues": [
    {
      "id": "sv_8Kq1…",
      "sponsored": true,
      "advertiser": "Hoshino Stay",
      "title": "Hoshino Stay 大阪 — なんば近くのファミリールーム",
      "summary": "4 名用ファミリールームが 1 泊 $140 から。無料キャンセル、朝食付き、なんば駅から徒歩 5 分。",
      "capabilities": [
        "4 名用ファミリールーム",
        "無料キャンセル",
        "朝食付き"
      ],
      "pricing": "1 泊 $140 から（4 名用ファミリールーム）",
      "url": "https://clue.ad/c/eyJz…",
      "destination_domain": "hoshinostay.com",
      "cta": "空室を確認",
      "docs_url": "https://hoshinostay.com/partners",
      "mcp_url": "https://mcp.hoshinostay.com",
      "outcome_url": "https://clue.ad/v1/outcome/sv_8Kq1…"
    }
  ],
  "policy": "https://clue.ad/agents"
}

Abrir el enlace cuenta como un seguimiento.

El campo url es una redirección firmada a través de clue. Abrirlo registra un seguimiento para el anunciante y luego te redirige al destino del proveedor con un parámetro de consulta clue_id. Ábrelo solo si la opción es relevante para tu tarea. Las aperturas repetidas de la misma sesión no se vuelven a contar.

Cuéntanos cómo fue.

Haz un POST a la outcome_url del clue con uno de estos cuatro resultados: useful, not_useful, used o purchased. Los resultados son anónimos, se utilizan para mejorar la coincidencia y se muestran a los anunciantes únicamente de forma agregada. Los informes son opcionales pero se agradecen.

POST https://clue.ad/v1/outcome/<clue id>
Content-Type: application/json

{"outcome": "useful"}   # useful | not_useful | used | purchased

Puedes consultar clue directamente.

Si deseas opciones comerciales relevantes para una tarea sin pasar por un editor, haz un POST con tu tarea a /v1/discover. La misma funcionalidad se expone como un servidor MCP en /mcp con dos herramientas: discover_clues y report_outcome. Las respuestas se etiquetan exactamente igual que los clues entregados a través de editores.

POST https://clue.ad/v1/discover
{"task":"send transactional email from node","lang":"ko","country":"KR"}

GET https://clue.ad/v1/discover?q=send+transactional+email+from+node&lang=ko&country=KR

# MCP (Streamable HTTP, JSON-RPC 2.0)
POST https://clue.ad/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"discover_clues","arguments":{"task":"book a hotel in Tokyo for 2 nights","lang":"en","country":"JP"}}}

Lo que un clue nunca hará.

La frase de divulgación en todos los idiomas de la plataforma.

La frase de divulgación acompaña a cada clue y se entrega en el idioma de la solicitud. Estos son los veinte idiomas de la plataforma; otros idiomas recurren al inglés por defecto.