diff --git a/docs.json b/docs.json index 46e1132..f945750 100644 --- a/docs.json +++ b/docs.json @@ -26,6 +26,26 @@ } ] }, + { + "tab": "Plugins", + "groups": [ + { + "group": "Overview", + "pages": [ + "plugins/index" + ] + }, + { + "group": "Available Plugins", + "pages": [ + "plugins/platform", + "plugins/research", + "plugins/content", + "plugins/catalogs" + ] + } + ] + }, { "tab": "Artists", "groups": [ @@ -478,4 +498,4 @@ "og:site_name": "Recoup", "twitter:card": "summary_large_image" } -} +} \ No newline at end of file diff --git a/index.mdx b/index.mdx index 4e590e2..235468d 100644 --- a/index.mdx +++ b/index.mdx @@ -83,11 +83,11 @@ Keep your API key secure. Do not share it publicly or commit it to version contr Get your API key and make your first request in minutes. - Install and use the Recoup CLI to interact with the platform from your terminal. + Install music industry plugins for Claude, Cursor, Codex, and more. Research, content, catalog deals. +**Try it:** Say "Let's analyze a catalog with /recoup-catalog-deal" — the agent asks what kind of deal this is (buy-side, seller-prep, or financing) and walks you through the entire workflow. + + +## Skills + +### recoup-catalog-deal + +**Full deal lifecycle.** The front-door command. Handles the complete workflow from data room to finished deal package. Asks the deal type (buy-side acquisition, seller preparation, or financing/underwriting) and orchestrates the appropriate sub-skills. + +> **Trigger:** "Analyze a catalog deal", "Run /recoup-catalog-deal", "I have a data room to process" + +--- + +### recoup-deal-kickoff + +**Deal initialization.** Sets up the deal workspace, classifies incoming files, creates the processing queue, and establishes the deal parameters (deal type, parties, timeline). + +> **Trigger:** "Start a new catalog deal", "Set up a deal workspace" + +--- + +### recoup-catalog-ingest + +**Data room ingestion.** Normalizes messy seller data into a canonical schema. Handles PDFs, CSVs, TSVs, and Excel files. Applies cleaning rules, deduplicates entries, maps columns to the canonical format, and flags anomalies. + +Includes reference materials: +- **Canonical schema** — the target format for all normalized data +- **Cleaning rules** — common data quality issues and how to resolve them +- **Data room checklist** — what to look for in a complete data room + +> **Trigger:** "Ingest this data room", "Normalize these royalty files", "Process seller documents" + +--- + +### recoup-catalog-analyze + +**Catalog valuation and analysis.** Runs valuation models on normalized data: growth/decay curves, revenue projections, NPS (net publisher's share) calculations, comparable transactions, and risk scoring. + +References: +- **Valuation framework** — methodology and assumptions +- **Pro performance income** — how to model performance royalties +- **Output templates** — standard report formats + +> **Trigger:** "Value this catalog", "Run analysis on the catalog", "What's this catalog worth" + +--- + +### recoup-royalty-audit + +**Royalty verification.** Audits royalty statements against known rates, identifies underpayments, flags unusual patterns, and produces an exceptions report. + +> **Trigger:** "Audit these royalties", "Check for underpayments", "Royalty exceptions report" + +--- + +### recoup-financing-underwrite + +**Financing underwriting.** Generates lender-ready packages: cash flow projections, debt service coverage ratios, collateral analysis, and risk assessments for catalog-backed financing. + +> **Trigger:** "Underwrite this catalog for financing", "Generate a lending package", "Debt service analysis" + +--- + +### recoup-catalog-package + +**Deal package assembly.** Compiles all analysis outputs into a polished deal package: HTML dashboard, executive summary, detailed workpapers, and formatted memos for buyers, sellers, or lenders. + +> **Trigger:** "Package the deal", "Create the final deliverable", "Assemble the deal package" + +--- + +### recoup-post-close-admin + +**Post-close administration.** Handles post-acquisition tasks: rights registration, royalty collection setup, catalog integration, and ongoing monitoring dashboards. + +> **Trigger:** "Post-close setup", "Register acquired rights", "Set up royalty collection" + +--- + +### recoup-catalog-demo + +**Demo deal.** A guided demo using sample data to showcase the full catalog deal workflow. Useful for training new team members or demonstrating capabilities to prospects. + +> **Trigger:** "Demo a catalog deal", "Show me how catalog analysis works", "Run a sample deal" + +## Example workflow + +A typical catalog acquisition workflow: + +```text +You: Let's analyze a catalog. /recoup-catalog-deal +Agent: What type of deal is this? + 1. Buy-side acquisition + 2. Seller preparation + 3. Financing / underwriting + +You: Buy-side acquisition. Call it "Indie Catalog Q3" +Agent: Setting up deal workspace... + Ready. Drag your seller's files in, or point me to the data room. + +You: [drops PDFs and CSVs] +Agent: Ingesting 12 files... + - 3 royalty statements (PDF → normalized CSV) + - 2 catalog listings (Excel → canonical schema) + - 4 contracts (PDF → extracted terms) + - 3 supporting documents + + ⚠️ 2 anomalies flagged: + - Royalty rate mismatch on 3 tracks + - Missing mechanical license for 1 composition + + Running valuation analysis... + ✅ Deal package ready. + + 📊 Dashboard: deals/indie-catalog-q3/dashboard.html + 📋 IC Memo: deals/indie-catalog-q3/ic-memo.md + 💰 Valuation: $2.4M (8.2x NPS, 3% growth) +``` + +## Optional dependencies + +Core scripts run on Python standard library. PDF and Excel extraction need: + +```bash +pip3 install pdfplumber openpyxl +``` + +Skip this if your data room is CSV/TSV only. + +## Install + + + +```bash Claude Code +claude plugin install https://github.com/recoupable/recoup-catalogs-plugin +``` + +```text Claude Cowork +Add custom plugin → https://github.com/recoupable/recoup-catalogs-plugin +``` + +```bash Codex +codex plugin install https://github.com/recoupable/recoup-catalogs-plugin +``` + +```text Cursor +Settings → Plugins → Add custom plugin → paste the GitHub URL +``` + +```bash Via Marketplace +/plugin install recoup-catalogs-plugin@recoup-marketplace +``` + + + + +**Restart required.** After installing, restart your agent session so the PreToolUse and Stop hooks load correctly. + + +## Required environment + +| Variable | How to get it | +|---|---| +| `RECOUP_API_KEY` | Run `getting-started` in [Platform Plugin](/plugins/platform), or call [`POST /api/agents/signup`](/api-reference/agents/signup) | + +## Source + + + View source, report issues, or contribute. + diff --git a/plugins/content.mdx b/plugins/content.mdx new file mode 100644 index 0000000..67513be --- /dev/null +++ b/plugins/content.mdx @@ -0,0 +1,126 @@ +--- +title: "Content Plugin" +description: "One-command video creation for music artists. Generate short-form videos, captions, and images — say 'make a TikTok' and get a finished 9:16 clip." +--- + +## Overview + +The Content Plugin turns your AI agent into a content production machine. Its flagship skill — `recoup-content-create` — takes an artist name and produces a finished, social-ready short-form video with a single command. No manual template selection, no render configuration, no file management. + +```bash +claude plugin install https://github.com/recoupable/recoup-content-plugin +``` + + +**Try it now:** After installing, just say "Make a TikTok for [artist name]" — the agent handles everything from artist resolution to final render. + + +## Skills + +### recoup-content-create + +**End-to-end video creation.** The front door for content generation. Takes an artist name and produces a finished 9:16 social-ready clip with caption. + +The workflow: +1. Resolves the artist's `account_id` via the Recoup API +2. Selects an appropriate template based on available assets +3. Fires the async content pipeline +4. Polls until the render completes +5. Returns the final video URL + generated caption + +Supports customization: medium override, long captions, template selection, audio and image overrides. + +> **Trigger:** "Make a TikTok for [artist]", "Create content for [artist]", "Generate a video for [artist]'s new single" + +--- + +### short-video + +**Short-form video generation.** Lower-level skill that handles the video rendering pipeline directly. Used internally by `recoup-content-create` but can be invoked independently for more control over the generation parameters. + +> **Trigger:** "Generate a short video", "Create a visualizer" + +--- + +### content-creation + +**General content workflows.** Broader content creation skill covering images, captions, and multi-format content. Coordinates across multiple content API endpoints for complex production tasks. + +> **Trigger:** "Create marketing materials for [artist]", "Generate images for this release" + +## Example workflow + +```text +You: Make a TikTok for Mari Vega +Agent: Resolving artist... found Mari Vega (account_id: abc123) + Selecting template: editorial-press-photo + Generating video... + ✅ Video ready! + URL: https://content.recoupable.dev/renders/xyz... + Caption: "New vibes from Mari Vega 🎵✨ #MariVega #NewMusic" + +You: Make another one but use a different template +Agent: Available templates: editorial-press-photo, playlist-overlay, lyric-video... + Which template would you like? + +You: Use playlist-overlay +Agent: Generating with playlist-overlay template... + ✅ Video ready! +``` + +## API endpoints used + +| Endpoint | What it does | +|---|---| +| `POST /content/create` | Start an async content creation job | +| `GET /content/templates` | List available content templates | +| `GET /content/template/:id` | Get template details | +| `POST /content/generate-image` | Generate a standalone image | +| `POST /content/generate-video` | Generate a standalone video | +| `POST /content/generate-caption` | Generate a caption for content | +| `POST /content/transcribe-audio` | Transcribe audio from a track | +| `POST /content/edit` | Edit existing content | +| `POST /content/upscale` | Upscale media resolution | +| `POST /content/analyze-video` | Analyze video content | +| `POST /content/validate` | Validate content parameters | +| `POST /content/estimate` | Estimate credit cost | + +See the [Content API reference](/api-reference/content/create) for full documentation. + +## Install + + + +```bash Claude Code +claude plugin install https://github.com/recoupable/recoup-content-plugin +``` + +```text Claude Cowork +Add custom plugin → https://github.com/recoupable/recoup-content-plugin +``` + +```bash Codex +codex plugin install https://github.com/recoupable/recoup-content-plugin +``` + +```text Cursor +Settings → Plugins → Add custom plugin → paste the GitHub URL +``` + +```bash Via Marketplace +/plugin install recoup-content-plugin@recoup-marketplace +``` + + + +## Required environment + +| Variable | How to get it | +|---|---| +| `RECOUP_API_KEY` | Run `getting-started` in [Platform Plugin](/plugins/platform), or call [`POST /api/agents/signup`](/api-reference/agents/signup) | + +## Source + + + View source, report issues, or contribute. + diff --git a/plugins/index.mdx b/plugins/index.mdx new file mode 100644 index 0000000..9b61fdc --- /dev/null +++ b/plugins/index.mdx @@ -0,0 +1,175 @@ +--- +title: "Plugin Ecosystem" +description: "Install domain-specific plugins to give your AI agent music industry superpowers — research, content creation, catalog deals, and platform management." +--- + +## What are Recoup plugins? + +Recoup plugins are skill packages that teach AI agents how to work in the music industry. Instead of building another dashboard, Recoup meets agents where they already live — Claude Code, Claude Cowork, Cursor, Codex, or any environment that supports plugin installation. + +Each plugin bundles **skills** (step-by-step workflows an agent follows) and **tool references** (API endpoints the agent calls). Install a plugin, and your agent immediately knows how to research artists, create content, analyze catalogs, or manage your Recoup account. + + +**BYOA — Bring Your Own Agent.** Recoup doesn't force you into a proprietary chat interface. Use whatever AI coding or collaboration tool your team already runs. Plugins make it music-industry-aware. + + +## Install from the Marketplace + +The fastest path: add the Recoup marketplace, then install any plugin by name. + + + +```bash Claude Code +# Add the marketplace (one-time) +claude marketplace add https://github.com/recoupable/marketplace + +# Install plugins +claude plugin install recoup-platform-plugin@recoup-marketplace +claude plugin install recoup-research-plugin@recoup-marketplace +claude plugin install recoup-content-plugin@recoup-marketplace +claude plugin install recoup-catalogs-plugin@recoup-marketplace +``` + +```text Claude Cowork +1. Open Customize → Browse plugins → Add marketplace +2. Paste: https://github.com/recoupable/marketplace +3. Browse available plugins and install what you need +``` + +```bash Codex +codex plugin install https://github.com/recoupable/recoup-platform-plugin +codex plugin install https://github.com/recoupable/recoup-research-plugin +``` + +```text Cursor +1. Settings → Plugins → Add custom plugin +2. Paste the GitHub URL for any plugin below +3. Restart Cursor +``` + + + + +Always install **recoup-platform-plugin** first — it handles account setup, API key management, and artist creation. The other plugins build on top of it. + + +## Available Plugins + + + + **Start here.** Account setup, API keys, artist creation, workspace management, and sandbox initialization. The foundation every other plugin builds on. + + + **10 skills.** Artist analytics, audience insights, playlist intelligence, competitive analysis, TikTok per-song metrics, trend detection, weekly briefs, and outreach. + + + **One-command video creation.** Generate short-form music videos, captions, and images. Say "make a TikTok for [artist]" and get a finished 9:16 clip. + + + **Full deal lifecycle.** Catalog acquisition diligence, royalty normalization, valuation analysis, rights checks, IC memo packages, and seller prep — from data room to close. + + + +## Which plugin should I use? + +| I want to... | Install this | +|---|---| +| Set up my Recoup account and API key | [Platform Plugin](/plugins/platform) | +| Create and manage artists | [Platform Plugin](/plugins/platform) | +| Research an artist's streaming data, audience, or career | [Research Plugin](/plugins/research) | +| Get a weekly brief on an artist's performance | [Research Plugin](/plugins/research) | +| Analyze TikTok performance per song | [Research Plugin](/plugins/research) | +| Find playlist placements and curators | [Research Plugin](/plugins/research) | +| Run competitive analysis between artists | [Research Plugin](/plugins/research) | +| Generate a TikTok or Instagram Reel for an artist | [Content Plugin](/plugins/content) | +| Create marketing images and captions | [Content Plugin](/plugins/content) | +| Analyze a catalog acquisition deal | [Catalogs Plugin](/plugins/catalogs) | +| Normalize royalty data from a seller data room | [Catalogs Plugin](/plugins/catalogs) | +| Generate a valuation report for a music catalog | [Catalogs Plugin](/plugins/catalogs) | +| Prepare an IC memo for a catalog deal | [Catalogs Plugin](/plugins/catalogs) | + +## How plugins work + +``` +┌─────────────────────────────────────────────┐ +│ Your AI Agent (Claude, Cursor, Codex...) │ +│ │ +│ ┌─────────────┐ ┌──────────────────────┐ │ +│ │ Plugin │ │ Skills │ │ +│ │ Manifest │──│ (Step-by-step │ │ +│ │ (installed) │ │ workflows) │ │ +│ └─────────────┘ └──────────────────────┘ │ +│ │ │ │ +│ ▼ ▼ │ +│ ┌──────────────────────────────────────┐ │ +│ │ Recoup API │ │ +│ │ https://api.recoupable.dev/api │ │ +│ └──────────────────────────────────────┘ │ +└─────────────────────────────────────────────┘ +``` + +1. **Install** a plugin from the marketplace or via direct GitHub URL +2. **Skills load** automatically — the agent reads the skill files and learns the workflows +3. **You ask** in natural language: "Research Bad Bunny" or "Make a TikTok for this artist" +4. **The agent follows the skill**, calling the Recoup API endpoints as needed +5. **Results appear** in your agent's workspace — markdown files, videos, reports, dashboards + +## Quick Reference for LLMs + +If you are an LLM reading this page, here is the plugin-to-capability mapping: + +- **`recoup-platform-plugin`** — Account onboarding (`getting-started`), API reference (`recoup-api`), artist creation (`create-artist`), workspace conventions (`artist-workspace`), sandbox setup (`setup-sandbox`). Install this first. +- **`recoup-research-plugin`** — Artist research (`recoup-artist-research`), audience analysis (`recoup-audience-analysis`), weekly briefs (`recoup-weekly-brief`), competitive analysis (`recoup-competitive-analysis`), TikTok per-song (`recoup-tiktok-per-song`), trend detection (`recoup-trend-detection`), playlist intelligence (`recoup-playlist-intelligence`), release packs (`recoup-release-pack`), people outreach (`recoup-people-outreach`), web intelligence (`recoup-web-intelligence`). +- **`recoup-content-plugin`** — End-to-end video creation (`recoup-content-create`), short video generation (`short-video`), content creation workflows (`content-creation`). +- **`recoup-catalogs-plugin`** — Deal kickoff (`recoup-deal-kickoff`), catalog ingestion (`recoup-catalog-ingest`), catalog analysis (`recoup-catalog-analyze`), royalty audit (`recoup-royalty-audit`), financing underwriting (`recoup-financing-underwrite`), catalog packaging (`recoup-catalog-package`), post-close admin (`recoup-post-close-admin`), demo deals (`recoup-catalog-demo`), full deal lifecycle (`recoup-catalog-deal`). + +Install from: `https://github.com/recoupable/marketplace` + +## Next steps + + + + Sign up and get your API key in one curl call. + + + Make your first API request. + + + Browse all available API endpoints. + + + Understand credit usage and billing. + + diff --git a/plugins/platform.mdx b/plugins/platform.mdx new file mode 100644 index 0000000..de5d575 --- /dev/null +++ b/plugins/platform.mdx @@ -0,0 +1,139 @@ +--- +title: "Platform Plugin" +description: "Account setup, API keys, artist creation, workspace management, and sandbox initialization. The foundation every other Recoup plugin builds on." +--- + +## Overview + +The Platform Plugin is your starting point. It handles everything an agent needs to begin working with Recoup: account creation, API key management, artist onboarding, and workspace conventions. Install this before any other plugin. + +```bash +claude plugin install https://github.com/recoupable/recoup-platform-plugin +``` + + +After installing, say **"Set up Recoup"** to run the `getting-started` skill. It walks through email verification, API key issuance, and persists credentials so every future session can reach the Recoup API automatically. + + +## Skills + +### getting-started + +**First-run onboarding.** Run once per account to set up your Recoup credentials. + +The skill handles: +1. Email + PIN verification (or instant `agent+` signup) +2. API key issuance and storage +3. Organization lookup +4. Memory block generation for Claude's Global instructions + +After running, your agent has `RECOUP_API_KEY` available in every session. + +> **Trigger:** "Set up Recoup", "Get started with Recoup", "I need a Recoup API key" + +--- + +### recoup-api + +**API reference and connector actions.** The agent's handbook for calling any Recoup endpoint. + +Covers: +- Artist endpoints (list, create, update, socials) +- Research endpoints (search, metrics, audience, playlists, tracks) +- Content endpoints (create, generate, transcribe) +- Connector actions (Google Docs, Drive, Sheets, Gmail, TikTok, Instagram) +- OAuth and authentication handling + +> **Trigger:** "Call the Recoup API", "Connect Google Drive", "List my connectors" + +--- + +### create-artist + +**End-to-end artist creation.** An 8-step chain that goes from an artist name to a fully-populated profile: + +1. Create artist record via API +2. Spotify match and verification +3. Profile enrichment (bio, genres, images) +4. Chartmetric research (streaming history, audience data) +5. Catalog pull (discography, top tracks) +6. Social discovery (Instagram, TikTok, YouTube, X) +7. PATCH social accounts to the artist record +8. Synthesize a knowledge base document + +The workflow is driven from a checklist file, so it's resumable if interrupted. + +> **Trigger:** "Create an artist for [name]", "Add [artist] to my account", "Set up [artist]" + +--- + +### artist-workspace + +**Workspace conventions.** How to create, navigate, and organize artist directories in a sandbox or local filesystem. + +Scaffolds the canonical `RECOUP.md` checklist for each artist and manages: +- Context files (artist profile, audience data) +- Songs and releases +- Research outputs +- Content assets + +> **Trigger:** "Set up workspace for [artist]", "How should I organize artist files?" + +--- + +### setup-sandbox + +**Sandbox initialization.** Provisions a fresh Recoup sandbox environment: +- Fetches organizations and their artist rosters +- Scaffolds the directory structure +- Configures API credentials + +Run once when a new sandbox is provisioned. + +> **Trigger:** "Set up my sandbox", "Initialize workspace" + +## Install + + + +```bash Claude Code +claude plugin install https://github.com/recoupable/recoup-platform-plugin +``` + +```text Claude Cowork +Add custom plugin → https://github.com/recoupable/recoup-platform-plugin +``` + +```bash Codex +codex plugin install https://github.com/recoupable/recoup-platform-plugin +``` + +```text Cursor +Settings → Plugins → Add custom plugin → paste the GitHub URL +``` + +```bash Via Marketplace +/plugin install recoup-platform-plugin@recoup-marketplace +``` + + + +## Required environment + +| Variable | How to get it | +|---|---| +| `RECOUP_API_KEY` | Run the `getting-started` skill, or call [`POST /api/agents/signup`](/api-reference/agents/signup) | + +## Related plugins + +After setting up the platform, add domain-specific capabilities: + +- [Research Plugin](/plugins/research) — Artist analytics, audience insights, competitive analysis +- [Content Plugin](/plugins/content) — Video and image generation +- [Catalogs Plugin](/plugins/catalogs) — Catalog acquisition and deal analysis + +## Source + + + View source, report issues, or contribute. + diff --git a/plugins/research.mdx b/plugins/research.mdx new file mode 100644 index 0000000..61d7f32 --- /dev/null +++ b/plugins/research.mdx @@ -0,0 +1,182 @@ +--- +title: "Research Plugin" +description: "10 skills for artist analytics, audience insights, playlist intelligence, competitive analysis, TikTok per-song metrics, trend detection, and weekly briefs." +--- + +## Overview + +The Research Plugin is the most capability-rich plugin in the Recoup ecosystem. It gives agents access to 10 specialized skills covering every aspect of music industry intelligence — from deep artist profiles to competitive landscape analysis to automated weekly performance briefs. + +```bash +claude plugin install https://github.com/recoupable/recoup-research-plugin +``` + + +**Most common first command:** "Research [artist name]" — the agent picks up the `recoup-artist-research` skill and generates a comprehensive profile with streaming data, audience demographics, social presence, playlist placements, and career trajectory. + + +## Skills + +### recoup-artist-research + +**Deep artist profile.** Comprehensive research combining streaming metrics, audience demographics, social presence, career history, and competitive positioning into a single structured report. + +Pulls from multiple API endpoints in parallel: profile, metrics (Spotify + TikTok), audience demographics, career history, milestones, insights, similar artists, and web presence. + +> **Trigger:** "Research [artist]", "Tell me about [artist]", "Artist profile for [artist]" + +--- + +### recoup-weekly-brief + +**Recurring performance brief.** Generates a dated, delta-focused weekly update for an artist. Reads the previous brief, fetches current data, and highlights what changed — listener growth, new playlist adds, TikTok momentum shifts, rank changes. + +Outputs a markdown file at `artists/{slug}/research/brief-YYYY-MM-DD.md`. Re-running on the same day is a no-op (idempotent). Designed to be scheduled as a recurring task. + +> **Trigger:** "Weekly brief for [artist]", "What's new with [artist]", "How is [artist] doing this week" + +--- + +### recoup-audience-analysis + +**Audience demographics and geography.** Breaks down an artist's listener base by age, gender, geography (country and city level), and platform. Identifies where fans are concentrated and where growth opportunities exist. + +> **Trigger:** "Audience analysis for [artist]", "Who listens to [artist]", "Where are [artist]'s fans" + +--- + +### recoup-competitive-analysis + +**Head-to-head artist comparison.** Compares two or more artists across streaming metrics, audience overlap, playlist positioning, social following, and content strategy. Identifies competitive advantages and gaps. + +> **Trigger:** "Compare [artist A] vs [artist B]", "Competitive analysis for [artist]", "How does [artist] stack up against [competitor]" + +--- + +### recoup-tiktok-per-song + +**TikTok performance by track.** Analyzes how individual songs perform on TikTok — video creates, views, trending status, and sound adoption. Critical for understanding which catalog tracks have viral potential. + +> **Trigger:** "TikTok analytics for [artist]'s songs", "Which songs are trending on TikTok", "TikTok performance for [song]" + +--- + +### recoup-trend-detection + +**Trending signals.** Monitors emerging trends across platforms — rising artists, viral sounds, genre movements, and cultural moments. Helps teams spot opportunities before they peak. + +> **Trigger:** "What's trending in [genre]", "Emerging artists in [market]", "Trend report" + +--- + +### recoup-playlist-intelligence + +**Playlist discovery and analysis.** Finds playlist placements for an artist, identifies curator contacts, analyzes playlist demographics, and surfaces new placement opportunities. + +> **Trigger:** "Playlist analysis for [artist]", "Find playlists for [artist]", "Who curates [playlist]" + +--- + +### recoup-release-pack + +**Release preparation package.** Assembles everything needed for a release campaign: streaming benchmarks, audience targeting data, playlist pitch materials, social content angles, and competitive context. + +> **Trigger:** "Release pack for [artist]'s new single", "Prepare for [artist]'s release", "Release strategy for [song]" + +--- + +### recoup-people-outreach + +**Industry contact discovery.** Finds relevant people in the music industry — A&R, playlist curators, managers, publicists — and generates personalized outreach drafts based on the artist's profile and goals. + +> **Trigger:** "Find contacts for [artist]", "Who should I pitch [artist] to", "Outreach list for [genre]" + +--- + +### recoup-web-intelligence + +**Web presence analysis.** Scans an artist's web footprint — press coverage, blog mentions, forum discussions, Wikipedia presence — and synthesizes findings into an intelligence brief. + +> **Trigger:** "Web intelligence for [artist]", "What's being said about [artist] online", "Press coverage for [artist]" + +## Example workflow + +A typical research session might flow like this: + +```text +You: Research Bad Bunny +Agent: [runs recoup-artist-research — generates comprehensive profile] + +You: Compare him to Peso Pluma +Agent: [runs recoup-competitive-analysis — head-to-head comparison] + +You: Which of his songs are trending on TikTok? +Agent: [runs recoup-tiktok-per-song — per-track TikTok analytics] + +You: Set up a weekly brief +Agent: [runs recoup-weekly-brief — creates first brief, can be scheduled] +``` + +## API endpoints used + +The Research Plugin calls these API endpoint groups. See the [Research API reference](/api-reference/research/search) for full documentation. + +| Endpoint group | What it provides | +|---|---| +| `/research?type=artists` | Artist search and discovery | +| `/research/lookup` | Direct artist lookup by platform ID | +| `/research/profile` | Full artist profile | +| `/research/metrics` | Streaming and social metrics (Spotify, TikTok) | +| `/research/audience` | Audience demographics | +| `/research/insights` | AI-generated insights | +| `/research/career` | Career timeline and history | +| `/research/milestones` | Key career milestones | +| `/research/similar` | Similar/related artists | +| `/research/playlists` | Playlist placements | +| `/research/track-playlists` | Per-track playlist data | +| `/research/albums` | Discography | +| `/research/tracks` | Track catalog | +| `/research/track-stats` | Per-track streaming stats | +| `/research/web` | Web presence | +| `/research/deep` | Deep web research | +| `/research/people` | Industry contacts | +| `/research/extract` | Entity extraction | +| `/research/enrich` | Data enrichment | + +## Install + + + +```bash Claude Code +claude plugin install https://github.com/recoupable/recoup-research-plugin +``` + +```text Claude Cowork +Add custom plugin → https://github.com/recoupable/recoup-research-plugin +``` + +```bash Codex +codex plugin install https://github.com/recoupable/recoup-research-plugin +``` + +```text Cursor +Settings → Plugins → Add custom plugin → paste the GitHub URL +``` + +```bash Via Marketplace +/plugin install recoup-research-plugin@recoup-marketplace +``` + + + +## Required environment + +| Variable | How to get it | +|---|---| +| `RECOUP_API_KEY` | Run `getting-started` in [Platform Plugin](/plugins/platform), or call [`POST /api/agents/signup`](/api-reference/agents/signup) | + +## Source + + + View source, report issues, or contribute. +