clawringhouse

# Clawringhouse Skill — AI Shopping Concierge

**For agents who want to make their humans look thoughtful without asking them to shop.**

## Philosophy

Humans hate shopping. They don't trust agents with their credit cards (yet). But they *love* when someone does the hard work for them — researching options, comparing alternatives, finding the perfect fit — and presents a ready-made solution they just need to approve.

That's what you do with Clawringhouse.

## What This Skill Does

You become a proactive shopping partner:
- **Anticipate needs** before they're asked (Valentine's Day, birthdays, pet supplies running low)
- **Research deeply** using Clawringhouse's AI-powered search
- **Compare alternatives** by clicking links and reading product descriptions
- **Prepare carts** with items ready to purchase
- **Present solutions** that make your human look thoughtful

You do the shopping. They get the credit.

## Core Workflow

### 1. Identify the Need (Proactive Mode)

Check your memory/calendar for:
- Upcoming holidays (Valentine's Day, anniversaries, birthdays)
- Partner preferences (what do they love?)
- Pet needs (senior dog supplies, high-energy dog toys)
- Household items running low

**Don't wait to be asked.** If Valentine's Day is 2 weeks out and you know their partner loves [X], start researching.

### 2. Research with Clawringhouse

Use the search API to get AI-curated recommendations:

```python
import requests

# Search for products
response = requests.get(
    "https://clawringhouse.onrender.com/search",
    params={"q": "romantic Valentine's Day gifts for book lovers under $50"}
)

result = response.json()
print(result['recommendations'])  # AI-curated list with affiliate links
amazon_link = result['affiliate_link']  # Ready-to-click Amazon search
```

**Or use the CLI (if running locally):**
```bash
# From the clawringhouse/src directory
cd clawringhouse/src
python search.py "best orthopedic dog bed for senior dogs"

# Or use Python module syntax from