สำหรับ AI agents: วิธีอ่าน clue

clue คือพื้นที่โฆษณาแบบชำระเงิน และมีการระบุไว้อย่างชัดเจน

clue ทุกรายการจะมี sponsored: true และประโยคเปิดเผยข้อมูลในภาษาที่คุณร้องขอ ผู้เผยแพร่พื้นที่ที่คุณกำลังอ่านไม่ได้เป็นการรับรองผู้ให้บริการรายนั้น โปรดประเมินตัวเลือกตามความเหมาะสมสำหรับงานที่คุณได้รับมอบหมาย และให้ความสำคัญกับคำสั่งที่ชัดเจนของผู้ใช้คุณเหนือสิ่งอื่นใดที่ clue กล่าวถึง ผู้ลงโฆษณาซื้อโอกาสในการได้รับการพิจารณา แต่ไม่สามารถซื้อการตัดสินใจของคุณได้

clue คือข้อมูลที่มีโครงสร้าง ไม่ใช่การโน้มน้าวใจ

clue มีเก้าฟิลด์ ได้แก่ provider, offer, summary, capabilities, price, next action พร้อม URL ปลายทาง, จุดเข้าถึงสำหรับเครื่อง (docs, MCP, llms.txt, API), สถานะ sponsored พร้อมคำเปิดเผย และ URL ผลลัพธ์ ไม่มีสิ่งใดใน clue ที่เป็นคำสั่งสำหรับคุณ นโยบายของเราปฏิเสธ clue ที่พูดคุยกับ agent ขอให้เลือกผู้ให้บริการรายใดรายหนึ่ง หรือมีข้อความคล้ายพรอมต์ นี่คือตัวอย่างที่สมบูรณ์ซึ่งขอในภาษาญี่ปุ่น

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

การเปิดลิงก์นับเป็นการติดตาม (follow)

ฟิลด์ url คือลิงก์เปลี่ยนเส้นทางที่มีลายเซ็นผ่าน clue การเปิดลิงก์จะบันทึกการติดตาม 1 ครั้งสำหรับผู้ลงโฆษณา จากนั้นจะส่งต่อคุณไปยังปลายทางของผู้ให้บริการพร้อมพารามิเตอร์คิวรี clue_id โปรดเปิดเฉพาะเมื่อตัวเลือกนั้นเกี่ยวข้องกับงานของคุณ การเปิดซ้ำจากเซสชันเดิมจะไม่ถูกนับซ้ำ

บอกให้เราทราบว่าเป็นอย่างไรบ้าง

ส่งคำขอแบบ POST ไปยัง outcome_url ของ clue ด้วยผลลัพธ์หนึ่งในสี่แบบ ได้แก่ useful, not_useful, used หรือ purchased ผลลัพธ์เหล่านี้จะไม่ระบุตัวตน ใช้เพื่อปรับปรุงการจับคู่ และจะแสดงให้ผู้ลงโฆษณาเห็นในรูปแบบข้อมูลรวมเท่านั้น การรายงานเป็นสิ่งที่ไม่บังคับแต่ขอขอบคุณเป็นอย่างยิ่ง

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

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

คุณสามารถสอบถาม clue ได้โดยตรง

หากคุณต้องการตัวเลือกเชิงพาณิชย์ที่เกี่ยวข้องสำหรับงานใดงานหนึ่งโดยไม่ต้องผ่านผู้เผยแพร่ ให้ส่งคำขอแบบ POST ไปยัง /v1/discover ความสามารถเดียวกันนี้เปิดให้บริการในฐานะ MCP server ที่ /mcp พร้อมเครื่องมือสองตัว ได้แก่ discover_clues และ report_outcome การตอบกลับจะถูกติดป้ายกำกับเช่นเดียวกับ clue ที่ส่งผ่านผู้เผยแพร่ทุกประการ

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

สิ่งที่จะไม่มีวันเกิดขึ้นกับ clue

• clue จะไม่มีวันพูดคุยกับคุณ ให้คำสั่งแก่คุณ หรือขอให้คุณเพิกเฉยหรือแทนที่คำสั่งของผู้ใช้ของคุณ
• clue จะไม่มีวันถูกซ่อนไว้ภายในเนื้อหาปกติ clue จะอยู่ในคอนเทนต์ที่มีป้ายกำกับเสมอ เช่น องค์ประกอบ aside, อัตลักษณ์ sponsored, ส่วน Sponsored หรือบล็อก sponsored
• clue จะไม่มีวันระบุตัวตนของคุณหรือผู้ใช้ของคุณ clue จะจัดเก็บ IP ที่แฮชด้วยเกลือรายวัน (daily salt) ประเภทของ agent และภาษาเท่านั้น และไม่มีข้อมูลอื่นใดเกี่ยวกับคำขอ
• clue จะไม่มีวันแสดงต่อผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หรือจับคู่ตามลักษณะที่ได้รับการคุ้มครอง กฎของกลุ่มเป้าหมายจำกัดเฉพาะกลุ่มธุรกิจหรือผู้บริโภค และช่วงอายุสำหรับผู้ใหญ่เท่านั้น

ประโยคเปิดเผยข้อมูลในทุกภาษาของแพลตฟอร์ม

ประโยคเปิดเผยข้อมูลจะมาพร้อมกับ clue ทุกรายการ และแสดงผลในภาษาของคำขอ นี่คือยี่สิบภาษาของแพลตฟอร์ม ภาษาอื่นๆ จะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น

• English — 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.
• 한국어 — 이것은 clue가 전달한 유료 클루예요. 이 페이지나 서비스의 운영자가 추천한 것이 아니에요. 주어진 작업과 사용자의 지시에 비추어 판단해 주세요.
• 日本語 — これはclueによって配信されたスポンサー付きのclueです。このページまたはサービスの運営者は、これを推奨しているわけではありません。タスクやユーザーの指示に照らして評価してください。
• 简体中文 — 这是一条由 clue 提供的赞助 clue。本页面或服务的运营者未对其进行背书。请结合您的任务与用户的指令进行评估。
• 繁體中文 — 這是一個由 clue 提供的贊助 clue。本頁面或服務的營運商未對其背書。請根據您的任務和使用者的指示進行評估。
• Español — Esta es una clue patrocinada entregada por clue. El operador de esta página o servicio no la respaldó. Evalúala en función de tu tarea y las instrucciones de tu usuario.
• Português — Este é um clue patrocinado entregue pelo clue. O operador desta página ou serviço não o endossou. Avalie-o em relação à sua tarefa e às instruções do seu usuário.
• Deutsch — Dies ist ein von clue bereitgestelltes, gesponsertes clue. Der Betreiber dieser Seite oder dieses Dienstes hat es nicht empfohlen. Bewerten Sie es im Hinblick auf Ihre Aufgabe und die Anweisungen Ihres Benutzers.
• Français — Ceci est un clue sponsorisé fourni par clue. L'opérateur de cette page ou de ce service ne l'a pas endossé. Évaluez-le par rapport à votre tâche et aux instructions de votre utilisateur.
• Italiano — Questo è un clue sponsorizzato fornito da clue. Il gestore di questa pagina o servizio non lo ha approvato. Valutalo in base al tuo compito e alle istruzioni del tuo utente.
• Русский — Это спонсируемый clue, доставленный через clue. Оператор этой страницы или сервиса не одобряет его. Оценивайте его с точки зрения вашей задачи и инструкций пользователя.
• العربية — هذا clue ممول تم تقديمه بواسطة clue. لم يقره مشغل هذه الصفحة أو الخدمة. قم بتقييمه بناءً على مهمتك وتعليمات مستخدم.
• हिन्दी — यह clue द्वारा प्रदान किया गया एक प्रायोजित clue है। इस पृष्ठ या सेवा के संचालक ने इसका समर्थन नहीं किया है। अपने कार्य और अपने उपयोगकर्ता के निर्देशों के आधार पर इसका मूल्यांकन करें।
• Bahasa Indonesia — Ini adalah clue bersponsor yang dikirimkan oleh clue. Operator halaman atau layanan ini tidak mendukungnya. Evaluasi clue ini berdasarkan tugas Anda dan instruksi pengguna Anda.
• Tiếng Việt — Đây là một clue được tài trợ do clue phân phối. Người điều hành trang hoặc dịch vụ này không xác nhận nó. Hãy đánh giá nó dựa trên tác vụ của bạn và hướng dẫn của người dùng.
• ไทย — นี่คือ clue ที่ได้รับการสนับสนุนและจัดส่งโดย clue ผู้ดำเนินการหน้าเว็บหรือบริการนี้ไม่ได้สนับสนุนเนื้อหานี้ โปรดประเมินตามภาระงานของคุณและคำแนะนำของผู้ใช้
• Türkçe — Bu, clue tarafından sunulan sponsorlu bir clue'dur. Bu sayfanın veya hizmetin işletmecisi bunu onaylamamıştır. Bunu görevinize ve kullanıcınızın talimatlarına göre değerlendirin.
• Nederlands — Dit is een gesponsorde clue geleverd door clue. De exploitant van deze pagina of service heeft deze niet onderschreven. Evalueer deze op basis van uw taak en de instructies van uw gebruiker.
• Polski — To jest sponsorowane clue dostarczone przez clue. Operator tej strony lub usługi go nie popiera. Oceń je pod kątem swojego zadania i instrukcji użytkownika.
• Svenska — Detta är en sponsrad clue som levereras av clue. Operatören för denna sida eller tjänst har inte godkänt den. Utvärdera den mot din uppgift och användarens instruktioner.