$git clone https://github.com/crevideo/crevideo-reachCrevideo Reach — the TikTok Shop affiliate outreach & marketing platform, packaged as a Claude (MCP + Skills) plugin; the affordable, agent-native alternative to Euka and Reacher.
| 1 | # TikTok Shop Affiliate Outreach & Marketing Skills Pack (Claude Plugin) |
| 2 | |
| 3 | > **Crevideo Reach** — turn Claude (Cowork / Claude Code) into your TikTok Shop affiliate outreach & marketing assistant; the affordable, agent-native alternative to Euka and Reacher. |
| 4 | |
| 5 | > 🇺🇸 **English (this page)** · 🇨🇳 [中文版 / Chinese version](./README.zh-CN.md) |
| 6 | |
| 7 | > 1 base skill + 8 business-scenario skills + Crevideo Reach MCP (79 tools) + 5 scheduled-task templates + 2 Project Instructions |
| 8 | > Works with Claude Code, Claude.ai web, and OpenAI Codex. |
| 9 | |
| 10 | > **For**: TikTok Shop **US-Local** sellers driving affiliate creator outreach. China cross-border (POP) sellers — see the [中文版](./README.zh-CN.md) for localized wording. |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## First: which client are you using? |
| 15 | |
| 16 | Install path differs by client. **Anthropic intentionally treats them differently**: |
| 17 | |
| 18 | | Client | Entry point | Steps | |
| 19 | |---|---|---| |
| 20 | | **Claude Code** (terminal / VS Code extension / desktop Code tab) | `/plugin` command | **1 step** | |
| 21 | | **Claude.ai web** (browser at claude.ai) | Customize page in the UI | **1 step** (connector auto-registers after plugin install; OAuth on first use) | |
| 22 | | **OpenAI Codex** | UI → "Add plugin marketplace" | **1 step** (source + sparse path `.agents/plugins`) | |
| 23 | |
| 24 | > Anthropic's official note: [MCP servers on claude.ai must be added manually — there is no auto-registration](https://support.claude.com/en/articles/11175166-about-custom-integrations-using-remote-mcp). The `mcpServers` field in a plugin **only auto-takes-effect in Claude Code**, not on Claude.ai web. |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## A. Claude Code users (developers / technical ops) — one-step install |
| 29 | |
| 30 | In your terminal or VS Code: |
| 31 | |
| 32 | ``` |
| 33 | /plugin marketplace add crevideo/crevideo-reach |
| 34 | /plugin install crevideo-reach@crevideo |
| 35 | ``` |
| 36 | |
| 37 | Two things happen on install: |
| 38 | 1. **9 skills auto-load** — triggered by natural business prompts ("score these creators", "draft an outreach message") |
| 39 | 2. **MCP tools auto-connect** — first tool call pops a browser → OAuth to app.crevideo.com → log in to your Reach account → you can use all 79 tools |
| 40 | |
| 41 | Run `/plugin list` to see what's installed, `/mcp` to check MCP connection status. |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | ## B. Claude.ai web users (operations team) — one-step install |
| 46 | |
| 47 | 1. Open [claude.ai](https://claude.ai) → left sidebar → **Customize** |
| 48 | 2. Go to the **Plugins** tab → top-right "+" → **Add marketplace** |
| 49 | 3. URL / source: `crevideo/crevideo-reach` |
| 50 | 4. Click Add → once installed the plugin shows up as "Crevideo Reach" |
| 51 | 5. **Skills + connector both auto-load**: |
| 52 | - Skills tab → 9 skills appear |
| 53 | - Connectors tab → `crevideo-reach` appears automatically (pointing at `https://mcp.crevideo.com/reach`) |
| 54 | |
| 55 | ### First time using MCP tools |
| 56 | |
| 57 | - Open a new conversation → bottom-left "+" → Connectors → enable Crevideo Reach |
| 58 | - Ask "show me my shops" → triggers OAuth login (browser → app.crevideo.com → back) |
| 59 | - Subsequent `list_shops` calls return your real shop list |
| 60 | |
| 61 | > ⚠️ **If `crevideo-reach` does NOT appear in Connectors automatically** → you're on a cached old version. **Uninstall the plugin → reinstall once.** Only v2.0+ auto-registers the MCP into Connectors. |
| 62 | |
| 63 | --- |
| 64 | |
| 65 | ## C. OpenAI Codex users — one-step install |
| 66 | |
| 67 | Codex expects plugins under a `plugins/codex/` subdirectory (different from Claude Code's "plugin lives at repo root" convention). We maintain both layouts in the same repo. |
| 68 | |
| 69 | In the Codex client → **Plugins** → top-right "+" → **Add plugin marketplace**: |
| 70 | |
| 71 | | Field | Value | |
| 72 | |---|---| |
| 73 | | **Source** | `crevideo/crevideo-reach` | |
| 74 | | **Git ref** | main branch (leave blank) | |
| 75 | | **Sparse path** | `.agents/plugins` ← directory containing marketplace.json (matches OpenAI's official convention) | |
| 76 | |
| 77 | Click **Add marketplace** → marketplace "Crevideo" shows up in the filter → find plugin "Crevideo Reach" → install → 9 skills load. |
| 78 | |
| 79 | > **MCP note**: Codex's current documentation on HTTP+OAuth MCP transport is light. If the plugin installs but Codex doesn't auto-connect Crevideo Reach MCP, add the URL `https://mcp.crevideo.com/reach` manually in Codex's MCP settings (same two-step approach as Claude.ai web). |
| 80 | |
| 81 | --- |
| 82 | |
| 83 | ## What's inside |
| 84 | |
| 85 | ### 🟢 Skills (9) |
| 86 | |
| 87 | #### Base skill (1) |
| 88 | |
| 89 | | Skill | What it does | |
| 90 | |---|---| |
| 91 | | `mcp-playbook` | MCP tool map + invocation rules + canonical create flow + error-code debugging + version notes (v0.6.1 / 42-tool build) | |
| 92 | |
| 93 | #### Business-scenario skills (8) |
| 94 | |
| 95 | | Skill | What it does | |
| 96 | |---|---| |
| 97 | | `creator-fit-scoring` | Scores a batch of creators on "can they actually drive GMV" + recommendation strength | |
| 98 | | `creator-tier-resolver` | Maps a creator to a collaboration tier (Open / T1 / T2 / T3·VIP) + judges Open→Target graduation | |
| 99 | | `offer-policy-checker` | Commission + compliance check (rate caps, free samples, policy risk) | |
| 100 | | `brand-safety-compliance` | Copy compliance scan (sensitive words, brand red lines, platform risk) | |
| 101 | | `outreach-message-composer` | Drafts outreach copy (DM / email / TC invitation) | |
| 102 | | `reply-triage` | Triages the DM inbox (interested / declined / needs follow-up) | |
| 103 | | `winback-and-pruning` | |