From 365547028320bf339783a1ecc34f14e56eb05ebc Mon Sep 17 00:00:00 2001 From: Recoupable Date: Fri, 24 Jul 2026 01:10:14 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20add=20Plugin=20Ecosystem=20section=20?= =?UTF-8?q?=E2=80=94=205=20new=20pages=20documenting=20all=204=20Recoup=20?= =?UTF-8?q?plugins?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit New pages: - plugins/index.mdx — ecosystem overview, capability map, install guides, LLM quick reference - plugins/platform.mdx — 5 skills: getting-started, recoup-api, create-artist, artist-workspace, setup-sandbox - plugins/research.mdx — 10 skills: artist-research, weekly-brief, audience, competitive, tiktok-per-song, trends, playlists, release-pack, outreach, web-intel - plugins/content.mdx — 3 skills: recoup-content-create, short-video, content-creation - plugins/catalogs.mdx — 9 skills: catalog-deal, deal-kickoff, catalog-ingest, catalog-analyze, royalty-audit, financing-underwrite, catalog-package, post-close-admin, catalog-demo Updated: - docs.json — new Plugins tab in navigation (position 2, after Quickstart) - index.mdx — Plugin Ecosystem card in Get Started section, LLM quick reference updated with plugin info Addresses roadmap P1 (agent onboarding docs) and P2 (agent discoverability). Previously, the docs site had zero mention of plugins despite them being the primary customer interaction surface. --- docs.json | 22 +++++- index.mdx | 14 ++-- plugins/catalogs.mdx | 184 +++++++++++++++++++++++++++++++++++++++++++ plugins/content.mdx | 126 +++++++++++++++++++++++++++++ plugins/index.mdx | 175 ++++++++++++++++++++++++++++++++++++++++ plugins/platform.mdx | 139 ++++++++++++++++++++++++++++++++ plugins/research.mdx | 182 ++++++++++++++++++++++++++++++++++++++++++ 7 files changed, 836 insertions(+), 6 deletions(-) create mode 100644 plugins/catalogs.mdx create mode 100644 plugins/content.mdx create mode 100644 plugins/index.mdx create mode 100644 plugins/platform.mdx create mode 100644 plugins/research.mdx diff --git a/docs.json b/docs.json index 46e11323..f945750e 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 4e590e2f..235468d6 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 00000000..67513bee --- /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 00000000..9b61fdc9 --- /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 00000000..de5d575f --- /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 00000000..61d7f323 --- /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. +