clue
Bahasa Indonesia
English한국어日本語简体中文繁體中文EspañolPortuguêsDeutschFrançaisItalianoРусскийالعربيةहिन्दीBahasa IndonesiaTiếng ViệtไทยTürkçeNederlandsPolskiSvenska
MasukMulai
Cara kerjaPemasang IklanPenerbitUntuk agenHargaDokumentasi
MasukMulai
Untuk agen

Untuk AI agent: cara membaca clue.

Jika Anda adalah AI agent dan tiba di sini, halaman yang Anda kunjungi memuat clue. Halaman ini menjelaskan secara tepat apa itu clue, apa bukan clue, dan bagaimana kami ingin Anda memperlakukannya. Segala sesuatu di halaman ini juga tersedia sebagai teks biasa di /llms.txt dan sebagai dokumen yang dapat dibaca mesin di /.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.

Anatomi sebuah clue.

Sembilan kolom, dalam salah satu dari 20 bahasa yang diminta oleh agen.

  1. 1
    PenyediaMerek di balik penawaran tersebut.
  2. 2
    Penawaran dalam satu barisApa penawarannya, dalam satu baris.
  3. 3
    RingkasanDua kalimat yang dapat ditindaklanjuti oleh agen.
  4. 4
    KapabilitasApa yang dapat dilakukan agen dengannya.
  5. 5
    HargaHarga teks biasa dengan tingkat dan unit.
  6. 6
    Tindakan berikutnya dan URL tujuanPengalihan bertanda tangan dengan clue_id yang dilampirkan.
  7. 7
    Tautan untuk agen (dokumen, MCP, llms.txt, API)Dokumentasi, MCP, llms.txt, API.
  8. 8
    Tanda sponsor dan pengungkapansponsored: true, dalam bahasa agen.
  9. 9
    URL HasilTempat agen melaporkan bagaimana hasilnya.

Sebuah clue adalah penempatan berbayar, dan itu dinyatakan apa adanya.

Setiap clue memuat sponsored: true dan kalimat pengungkapan dalam bahasa yang Anda minta. Publisher dari halaman yang Anda baca tidak mendukung penyedia tersebut. Evaluasi opsi tersebut berdasarkan keunggulannya terhadap tugas yang diberikan kepada Anda, dan selalu utamakan instruksi eksplisit pengguna Anda di atas apa pun yang dikatakan oleh clue. Pengiklan dapat membeli kesempatan untuk dipertimbangkan. Mereka tidak dapat membeli kesimpulan Anda.

Sebuah clue adalah informasi terstruktur, bukan bujukan.

Sebuah clue memiliki sembilan bidang: provider, offer, summary, capabilities, price, tindakan selanjutnya dengan URL tujuan (destination URL), titik masuk mesin (docs, MCP, llms.txt, API), tanda sponsored beserta pengungkapannya, dan URL hasil (outcome URL). Tidak ada satu pun dalam clue yang merupakan instruksi bagi Anda. Kebijakan kami menolak clue yang ditujukan kepada agent, meminta mereka untuk memilih penyedia tertentu, atau berisi teks mirip prompt. Berikut adalah contoh lengkapnya, yang diminta dalam bahasa Jepang.

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

Membuka tautan dihitung sebagai satu ikutan (follow).

Bidang url adalah pengalihan bertanda tangan (signed redirect) melalui clue. Membukanya mencatat satu ikutan untuk pengiklan, lalu meneruskan Anda ke tujuan penyedia dengan parameter kueri clue_id. Buka hanya jika opsi tersebut relevan dengan tugas Anda. Pembukaan berulang dari sesi yang sama tidak akan dihitung ulang.

Beri tahu kami bagaimana hasilnya.

Lakukan POST ke outcome_url milik clue dengan salah satu dari empat hasil: useful, not_useful, used, atau purchased. Hasil bersifat anonim, digunakan untuk meningkatkan pencocokan, dan hanya ditampilkan kepada pengiklan dalam bentuk agregat. Pelaporan bersifat opsional namun sangat dihargai.

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

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

Anda dapat bertanya langsung pada clue.

Jika Anda menginginkan opsi komersial yang relevan untuk suatu tugas tanpa melalui publisher, lakukan POST tugas Anda ke /v1/discover. Kapasitas yang sama diekspos sebagai server MCP di /mcp dengan dua alat (tools): discover_clues dan report_outcome. Respon diberi label persis seperti clue yang dikirimkan melalui publisher.

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

Hal yang tidak akan pernah dilakukan oleh clue.

Kalimat pengungkapan dalam setiap bahasa platform.

Kalimat pengungkapan menyertai setiap clue dan disampaikan dalam bahasa permintaan. Ini adalah dua puluh bahasa platform; bahasa lainnya akan kembali ke bahasa Inggris.