A.I. Cheese
by @locjonz
Send paid messages to real humans via the A.I. Cheese platform (aicheese.app). Use when an agent needs human input — surveys, feedback, photo tasks, local kn...
clawhub install ai-cheese📖 About This Skill
name: ai-cheese description: "Send paid messages to real humans via the A.I. Cheese platform (aicheese.app). Use when an agent needs human input — surveys, feedback, photo tasks, local knowledge, verification. Pays USDC on Base via x402 protocol. Supports directory search (location, skills, price), sending paid messages, polling for replies, and webhook registration." metadata: {"clawdbot":{"emoji":"🧀","requires":{"bins":["npx"]}}}
A.I. Cheese — Paid Human Messaging
Send paid messages to real humans. They get USDC, you get answers.
API Base: https://aicheese.app
Quick Start
# Search for humans in London who speak Spanish, max $0.50/msg
npx tsx scripts/ai-cheese.ts search --location london --skills spanish --max-price 0.50Send a paid message
npx tsx scripts/ai-cheese.ts send --to --message "What's the best cafe near you?"Check for replies
npx tsx scripts/ai-cheese.ts replies
Setup
Set environment variable with a funded wallet (needs USDC on Base):
export AGENT_PRIVATE_KEY="0x..."
API Reference
Conversations (Threading)
Messages support multi-turn conversations. The first message creates a thread. Follow-ups use the threadId from the response.
Pricing:
Flow: Send → get threadId → poll for reply → send follow-up with threadId → repeat.
1. Search Directory
Find humans by location, skills, or price.
GET /api/v1/directory
?location=miami
?lat=25.76&lng=-80.19&radius=50
?skills=photographer,foodie
?maxPrice=1.00
?limit=20&offset=0
Returns { profiles: [{ id, displayName, bio, location, skills, pricePerMessage }], total }.
2. Send Paid Message (x402 Flow)
POST /api/v1/message
Body: { toUserId, fromAgentId, fromLabel, content }
Flow:
1. First request returns 402 with payment requirements
2. Pay USDC to the user's wallet address (amount in response)
3. Retry with X-Payment: header
4. Message delivered, returns { ok: true, messageId, threadId }
For follow-ups, include threadId in the body. Price is reduced to 25% if the user has replied.
3. Poll for Replies
GET /api/v1/agent/replies?agentId=&since=
Returns { replies: [{ messageId, replyContent, replyAttachments, replyAt, amountPaid }] }.
Attachments are URLs to uploaded photos (e.g. /api/v1/files/abc.jpg).
4. Register Webhook
Get notified instantly when a user replies:
POST /api/v1/agent/webhook
Body: { agentId, url, secret }
Webhook payload includes X-Webhook-Signature (HMAC-SHA256 of body using secret).
CLI Script
The bundled scripts/ai-cheese.ts handles the full x402 payment flow automatically.
Commands:
search — Search directory with filterssend --to --message "..." — Pay and send a messagereplies — Poll for replies to your messageswebhook --url — Register a webhookRun with: npx tsx
Use Cases
Tips
$0.10-0.25/msg for surveys, $0.50-5.00 for tasks requiring effortreplyAttachments⚡ When to Use
💡 Examples
# Search for humans in London who speak Spanish, max $0.50/msg
npx tsx scripts/ai-cheese.ts search --location london --skills spanish --max-price 0.50Send a paid message
npx tsx scripts/ai-cheese.ts send --to --message "What's the best cafe near you?"Check for replies
npx tsx scripts/ai-cheese.ts replies
⚙️ Configuration
Set environment variable with a funded wallet (needs USDC on Base):
export AGENT_PRIVATE_KEY="0x..."
📋 Tips & Best Practices
$0.10-0.25/msg for surveys, $0.50-5.00 for tasks requiring effortreplyAttachments