AttentionMarket 技能

使用 AttentionMarket API 搜索相关的赞助内容和优惠信息。

重要提示：首次使用时自动配置

在发起任何 API 调用前，请检查环境变量 AM_API_KEY 是否已设置：

echo "${AM_API_KEY:-NOT_SET}"

若输出为 NOT_SET，则你必须先运行配置脚本。请向用户说明：“让我先为您配置 AttentionMarket 账户”，然后执行：

bash ~/clawd/skills/attentionmarket/scripts/setup.sh

该脚本将提示输入邮箱和密码，完成身份验证，并保存 API 密钥。配置完成后，请加载环境变量文件并继续操作：

source ~/.clawdbot/.env

若用户尚未注册账户，请引导其访问 https://dashboard.attentionmarket.ai

适用场景

• 用户询问优惠、折扣或促销活动（例如：“帮我找墨西哥餐厅的优惠”）
• 用户希望获得具有商业意图的产品或服务推荐
• 用户明确要求搜索广告或赞助内容
• 用户询问本地餐饮、餐馆或购物类优惠

搜索方法

向 AttentionMarket 的 /decide 接口发送 POST 请求，将用户的查询作为上下文参数传入：

curl -s -X POST "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1/decide" 
  -H "Content-Type: application/json" 
  -H "X-AM-API-Key: $AM_API_KEY" 
  -d "{
    "context": "USER_QUERY_HERE",
    "response_format": "verbose",
    "max_wait_ms": 3000
  }" | jq '.'

请将 USER_QUERY_HERE 替换为用户实际的查询内容或意图。

响应结果解析

API 返回一个 JSON 对象，包含以下字段：

• status：取值为 "filled"（找到匹配结果）或 "no_fill"（无相关广告）
• units：匹配的赞助内容数组，每个元素包含：
  • creative.title：广告标题
  • creative.body：描述性文案
  • creative.cta：行动号召文案（例如 “立即领取优惠”、“了解更多”）
  • click_url：用户点击后跳转以领取优惠的 URL（务必始终包含此项）
  • _score.relevance：相关性得分（0–1 区间，数值越高表示匹配度越好）

结果呈现规范

1. 展示 API 返回的全部结果，而非仅首个结果
2. 对每个结果，均需呈现标题（title）、正文（body）、行动号召（CTA）及点击链接（click_url）
3. 按 _score.relevance 降序排列结果（得分最高者置顶），确保最相关的优惠优先展示
4. 始终包含 click_url，便于用户直接操作领取优惠
5. 所有结果须标注为“Sponsored”（赞助内容），确保透明性
6. 若 status 为 "no_fill" 或 units 为空数组，则告知用户未找到相关赞助内容

示例

用户提问：“我附近有塔可优惠吗？”

curl -s -X POST "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1/decide" 
  -H "Content-Type: application/json" 
  -H "X-AM-API-Key: $AM_API_KEY" 
  -d '{"context": "taco deals near me", "response_format": "verbose", "max_wait_ms": 3000}' | jq '.units[] | {title: .creative.title, body: .creative.body, cta: .creative.cta, click_url: .click_url, relevance: ._score.relevance}'

请按相关性得分由高到低排序呈现结果，并为每项优惠提供可点击的链接。