affitor/affiliate-skills

affiliate-check

Live affiliate program data from openaffiliate.dev.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/affitor/affiliate-skills --skill affiliate-check

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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, no rate limits.

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

Related by task