# Setup guide — Product Catalog Enrichment Agent

## 1. Install and connect PIM

Install the agent and connect your catalog/PIM source.

```
pipx install catalog-enrich-agent
catalog-enrich-agent connect --pim shopify --taxonomy ./taxonomy.yml
catalog-enrich-agent doctor
```

## 2. Configure guardrails

No fabricated specs/claims is enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
NO_FABRICATED_SPECS=true
NO_INVENTED_CLAIMS=true
FLAG_MISSING_ATTRIBUTES=true
```

## 3. Define schema & taxonomy

Declare attributes and categories.

```
# taxonomy.yml
attributes: [material, dimensions, weight, color, compatibility]
categories: [Home > Kitchen > Cookware, ...]
```

## 4. Enrich samples

Run a batch and review flags and claims.

```
catalog-enrich-agent run --products ./batch.csv --explain
# prints enriched entries + flagged_for_review + claims_to_verify
```

## 5. Wire into the catalog

Enrich incoming products; flagged fields go to review.

```
# product in -> enrich from source -> flagged attributes/claims -> human review
```
