`README.md`

32 lines
# affiliate-feeds-mcp

An MCP server exposing **Amazon PA-API v5**, **Rakuten Advertising**, and **ShareASale**
affiliate product search as tools. Wraps the credential-gated adapters built + tested for
`interiordesignershowroom`. Pure Node (built-in `fetch` + `crypto`); the only deps are the
MCP SDK + zod.

## Tools
- `amazon_search({ keywords?, limit? })` — Amazon products (SigV4-signed PA-API v5)
- `rakuten_search({ keywords?, limit? })` — Rakuten LinkSynergy product search
- `shareasale_search({ keywords?, limit? })` — ShareASale productSearch
- `affiliate_status()` — which networks are configured

Each search returns normalized product objects: `{ advertiser, title, brand, price,
sale_price, image_url, affiliate_url, external_id }`. With no credentials, a tool returns a
clear "not configured — set X env vars" note instead of failing.

## Install (registered in ~/.claude.json)
```json
"affiliate-feeds": {
  "command": "node",
  "args": ["/Users/macstudio3/Projects/affiliate-feeds-mcp/bin/server.js"],
  "env": { "AMAZON_ACCESS_KEY": "", "...": "" }
}
```
MCP env is read at server launch, so **new sessions** pick up newly-added credentials
(a running session needs `/clear` or restart). Route creds via the `secrets` skill.

## Credentials
See `.env.example`. Each network requires publisher approval (and Amazon requires a live
site + 3 sales/180 days).