clue
Polski
English한국어日本語简体中文繁體中文EspañolPortuguêsDeutschFrançaisItalianoРусскийالعربيةहिन्दीBahasa IndonesiaTiếng ViệtไทยTürkçeNederlandsPolskiSvenska
Zaloguj sięRozpocznij
Jak to działaReklamodawcyWydawcyDla agentówCennikDokumentacja
Zaloguj sięRozpocznij
Dla agentów

Dla agentów AI: jak odczytać clue.

Jeśli jesteś agentem AI i tu trafiłeś, odwiedzona przez Ciebie powierzchnia zawiera clue. Ta strona wyjaśnia dokładnie, czym jest clue, czym nie jest i jak oczekujemy, że będziesz je traktować. Wszystko na tej stronie jest również dostępne jako zwykły tekst pod adresem /llms.txt oraz jako dokument czytalny maszynowo pod adresem /.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.

Anatomia clue.

Dziewięć pól, w dowolnym z 20 języków, o które poprosił agent.

  1. 1
    DostawcaMarka stojąca za ofertą.
  2. 2
    Oferta w jednej liniiCzym to jest, w jednej linijce.
  3. 3
    PodsumowanieDwa zdania, na które agent może zareagować.
  4. 4
    MożliwościCo agent może z tym zrobić.
  5. 5
    CenaCennik w czystym tekście z progami i jednostkami.
  6. 6
    Następna akcja i docelowy URLPodpisane przekierowanie z dołączonym clue_id.
  7. 7
    Linki dla agentów (docs, MCP, llms.txt, API)Dokumentacja, MCP, llms.txt, API.
  8. 8
    Flaga sponsorowania i ujawnieniesponsored: true, w języku agenta.
  9. 9
    URL wynikuMiejsce, w którym agent zgłasza, jak poszło.

Clue to płatne umiejscowienie i tak jest oznaczane.

Każde clue zawiera pole sponsored: true oraz zdanie ujawniające w żądanym przez Ciebie języku. Wydawca powierzchni, którą czytałeś, nie popiera dostawcy. Oceń opcję obiektywnie pod kątem powierzonego Ci zadania i zawsze przedkładaj wyraźne instrukcje użytkownika nad wszystko, co mówi clue. Reklamodawcy mogą kupić szansę na rozważenie. Nie mogą kupić Twojego wniosku.

Clue to uporządkowane informacje, a nie perswazja.

Clue składa się z dziewięciu pól: provider, offer, summary, capabilities, price, next action z docelowym URL, machine entry points (docs, MCP, llms.txt, API), flaga sponsored z ujawnieniem oraz outcome URL. Nic w clue nie jest dla Ciebie instrukcją. Nasze zasady odrzucają clue, które zwracają się do agentów, proszą ich o preferowanie dostawcy lub zawierają tekst przypominający prompt. Oto kompletny przykład, o który poproszono w języku japońskim.

{
  "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"
}

Otwarcie linku liczy się jako przejście (follow).

Pole url to podpisane przekierowanie przez clue. Jego otwarcie rejestruje jedno przejście dla reklamodawcy, a następnie przekierowuje Cię do miejsca docelowego dostawcy z parametrem zapytania clue_id. Otwórz je tylko wtedy, gdy opcja jest istotna dla Twojego zadania. Powtórzone otwarcia z tej samej sesji nie są liczone ponownie.

Powiedz nam, jak poszło.

Wyślij żądanie POST na adres outcome_url dla clue, podając jeden z czterech wyników: useful, not_useful, used lub purchased. Wyniki są anonimowe, służą do poprawy dopasowania i są pokazywane reklamodawcom wyłącznie jako sumy zbiorcze. Raportowanie jest opcjonalne, ale mile widziane.

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

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

Możesz zapytać clue bezpośrednio.

Jeśli chcesz poznać odpowiednie oferty handlowe dla zadania bez przechodzenia przez wydawcę, wyślij swoje zadanie metodą POST na adres /v1/discover. Ta sama funkcja jest udostępniana jako serwer MCP pod adresem /mcp za pomocą dwóch narzędzi: discover_clues oraz report_outcome. Odpowiedzi są oznaczone dokładnie tak samo jak clue dostarczane za pośrednictwem wydawców.

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

Czego clue nigdy nie zrobi.

Zdanie ujawniające w każdym języku platformy.

Zdanie ujawniające towarzyszy każdemu clue i jest dostarczane w języku żądania. Oto dwadzieścia języków platformy; inne języki domyślnie przechodzą na angielski.