affiliate-check

Files (71)

• marketplace.json · .claude-plugin/
• new-skill.md · .claude/commands/
• review.md · .claude/commands/
• test-skill.md · .claude/commands/
• .cursorrules
• ci.yml · .github/workflows/
• update-registry.yml · .github/workflows/
• .gitignore
• API.md
• CHANGELOG.md
• CLAUDE.md
• CONTRIBUTING.md
• LICENSE
• PLAN-launch-content.md
• PLAN-social-intelligence-upgrade.md
• PLAN-v2-skills-expansion.md
• QUICKSTART.md
• README.md
• SKILL.md
• VERSION
• AGENT-SOURCE-OF-TRUTH.md · docs/
• affiliate-funnel-overview.md · docs/
• distribution-strategy.md · docs/
• devto-article.md · docs/launch-content/
• linkedin-post.md · docs/launch-content/
• reddit-claudeai.md · docs/launch-content/
• show-hn.md · docs/launch-content/
• twitter-thread.md · docs/launch-content/
• awesome-list-pr-body.md · docs/pr-templates/
• list-entries.md · docs/pr-templates/
• sdd-review-prompt.md · docs/
• skill-roadmap.md · docs/
• devto-v1.2.md · drafts/
• hn-v1.2.md · drafts/
• linkedin-v1.2.md · drafts/
• x-thread-v1.2.md · drafts/
• evals.json · evals/
• package.json
• chatgpt.md · platforms/
• cursor.md · platforms/
• gemini.md · platforms/
• openclaw.md · platforms/
• bootstrap.md · prompts/
• registry.json
• distribute.sh · scripts/
• fix-frontmatter.js · scripts/
• generate-registry.js · scripts/
• run-evals.sh · scripts/
• setup
• affiliate-glossary.md · shared/references/
• affitor-branding.md · shared/references/
• case-studies.md · shared/references/
• feedback-protocol.md · shared/references/
• flywheel-connections.md · shared/references/
• ftc-compliance.md · shared/references/
• offer-frameworks.md · shared/references/
• platform-rules.md · shared/references/
• sample-api-response.json · shared/references/
• seo-strategy.md · shared/references/
• social-data-providers.md · shared/references/
• …and 11 more

SKILL.md (first lines)

# affiliate-check: Live Affiliate Program Data

Query affiliate program data from openaffiliate.dev in real-time. Persistent daemon
with in-memory cache — first call auto-starts the server, every subsequent call is instant.

## SETUP (run this check BEFORE any affiliate-check command)

Before using any command, find the skill and check if the binary exists:

```bash
# Check project-level first, then user-level
if test -x .claude/skills/affiliate-skills/tools/dist/affiliate-check; then
  A=.claude/skills/affiliate-skills/tools/dist/affiliate-check
elif test -x ~/.claude/skills/affiliate-skills/tools/dist/affiliate-check; then
  A=~/.claude/skills/affiliate-skills/tools/dist/affiliate-check
else
  echo "NEEDS_SETUP"
fi
```

Set `A` to whichever path exists and use it for all commands.

If `NEEDS_SETUP`:
1. Tell the user: "affiliate-check needs a one-time build (~10 seconds). OK to proceed?"
2. If approved, run: `cd <SKILL_DIR> && ./setup`
3. If `bun` is not installed: `curl -fsSL https://bun.sh/install | bash`

## Quick Reference

```bash
A=~/.claude/skills/affiliate-skills/tools/dist/affiliate-check

# Search programs
$A search "AI video tools"
$A search --recurring --tags ai

# Top programs
$A top
$A top --sort trending

# Program details
$A info heygen

# Compare programs side-by-side
$A compare heygen synthesia

# Server management
$A status
$A stop
```

## Commands

### Search
```
affiliate-check search <query>                    Search by name/keyword
affiliate-check search --recurring                Filter recurring commissions
affiliate-check search --tags ai,video            Filter by tags
affiliate-check search --min-cookie 30            Min cookie days
affiliate-check search --sort new                 Sort: trending | new | top
affiliate-check search --limit 20                 Result limit
```

### Discovery
```
affiliate-check top                               Top programs by stars
affiliate-check top --sort trending               Trending programs
affiliate-check top --sort new                    Newest programs
```

### Details
```
affiliate-check info <name>                       Detailed program card
affiliate-check compare <name1> <name2> [name3]   Side-by-side comparison
```

### Server
```
affiliate-check status                            Uptime, cache, API key status
affiliate-check stop                              Shutdown daemon
affiliate-check help                              Full help
```

## Environment

No environment variables required. The openaffiliate.dev API is fully public — no API key, no auth.

## Architecture

- Persistent Bun daemon on localhost (port 9500-9510)
- In-memory cache with 5-minute TTL
- State file: `/tmp/affiliate-check.json`
- Auto-shutdown after 30 min idle
- Server crash → auto-restarts on next command

From Affitor/affiliate-skills, MIT.

More from Affitor/affiliate-skills