mcpField
A
affiliate-check

affiliate-check

github.com/affitorMarketing & growth750433 installsUpdated 1w ago
Repository

About affiliate-check

affiliate-check is a command-line skill for querying live affiliate program data from openaffiliate.dev. It supports program discovery, filtering, detail lookup, and comparisons through a persistent daemon with an in-memory cache.

Key features

  1. 01Search affiliate programs
  2. 02Filter by tags and commission criteria
  3. 03Browse top, trending, and new programs
  4. 04View details and compare programs
  5. 05Persistent daemon with in-memory cache

Use cases

  1. 01Finding programs related to a topic
  2. 02Filtering for recurring commissions
  3. 03Comparing affiliate program details
  4. 04Checking current program rankings

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/affitor/affiliate-skills --skill affiliate-check

After installing, type/affiliate-checkin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

API.md
.cursorrules
.gitignore
CHANGELOG.md
LICENSE
CLAUDE.md
PLAN-v2-skills-expansion.md
CONTRIBUTING.md
QUICKSTART.md
README.md
PLAN-launch-content.md
PLAN-social-intelligence-upgrade.md
VERSION
.claude-plugin/
marketplace.json
.claude/commands/
new-skill.md
test-skill.md
review.md
.github/workflows/
update-registry.yml
ci.yml
docs/
AGENT-SOURCE-OF-TRUTH.md
affiliate-funnel-overview.md
distribution-strategy.md
sdd-review-prompt.md
docs/launch-content/
reddit-claudeai.md
linkedin-post.md
show-hn.md
twitter-thread.md
devto-article.md
docs/pr-templates/
list-entries.md
awesome-list-pr-body.md

Details

From the project README

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:

# 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

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

Comments

Markdown supported