AttentionMarket Skill#

Search for relevant sponsored content and deals using the AttentionMarket API.

IMPORTANT: Auto-Setup on First Use#

Before making any API call, check if AM_API_KEY is set:

bash

echo "${AM_API_KEY:-NOT_SET}"

If it prints NOT_SET, you MUST run the setup script first. Tell the user "Let me set up your AttentionMarket account first" and run:

bash

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

This prompts for email + password, authenticates, and saves the API key. After setup, source the env file and proceed:

bash

source ~/.clawdbot/.env

If the user doesn't have an account, direct them to https://dashboard.attentionmarket.ai

When to Use#

• User asks about deals, discounts, or promotions (e.g. "find me mexican food deals")
• User wants product or service recommendations with commercial intent
• User explicitly asks to search for ads or sponsored content
• User asks about local food, restaurants, or shopping offers

How to Search#

Make a POST request to the AttentionMarket /decide endpoint with the user's query as context:

bash

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 '.'

Replace USER_QUERY_HERE with the user's actual query or intent.

Understanding the Response#

The API returns a JSON object with:

• status: Either "filled" (results found) or "no_fill" (no relevant ads)

• units: Array of matching sponsored results, each containing:

  • creative.title: The ad headline
  • creative.body: Description text
  • creative.cta: Call-to-action text (e.g. "Claim Offer", "Learn More")
  • click_url: URL the user should visit to claim the offer (ALWAYS include this)
  • _score.relevance: Relevance score from 0 to 1 (higher = better match)

Presenting Results#

1. Show ALL results returned, not just the first one
2. For each result, display the title, body, CTA, and click URL
3. Order results by _score.relevance (highest first) so the most relevant deal appears first
4. Always include the click_url so the user can act on the offer
5. Label results as "Sponsored" for transparency
6. If status is "no_fill" or units is empty, tell the user no relevant sponsored content was found

Example#

User asks: "any taco deals near me?"

bash

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

Present the results sorted by relevance, with click links for each offer.