KOL Creator Discovery for Openclaw

Openclaw Skills turns one creator profile into a verified, outreach-ready KOL prospect list with similarity ranking, email enrichment, and evidence-backed metadata.

baofeng-tech
v1.0.0
Jul 12, 2026
0
532
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install kol-creator-discovery

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install kol-creator-discovery using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is KOL Creator Discovery?

Openclaw Skills for KOL Creator Discovery is a creator research workflow that transforms a single TikTok, Instagram, or YouTube profile URL into a structured prospecting report. It uses AIsa WaveInflu APIs to find the seed creator's contact data, discover similar creators on the target platform, and enrich each recommendation with verified email information when available.

This skill is built for operators who need accurate influencer outreach lists without guessing emails or fabricating data. Openclaw Skills preserves API-sourced facts, keeps similarity ranking intact, and returns a clean Markdown table plus JSON output that can be reviewed, shared, or imported into downstream workflows.

KOL Creator Discovery Use Cases

  • Build influencer and KOL outreach lists from a single seed creator profile
  • Discover similar YouTube or TikTok creators for campaign expansion
  • Enrich creator prospects with verified contact emails from API lookup results
  • Research creators by content direction, region, language, and audience size
  • Generate evidence-based prospect tables for sales, partnerships, and brand outreach
  • Validate creator contact availability before manual outreach or CRM import
  • Produce a concise report with both Markdown and JSON outputs for Openclaw Skills workflows

How KOL Creator Discovery Works

  1. Validate the brief by collecting a seed creator profile URL, the target discovery platform, a recommendation limit, and any optional filters such as content direction, regions, languages, follower range, or average-view range.
  2. Resolve the input platform from the seed URL when possible. If the seed is Instagram, require a target platform and content direction because similarity matching needs explicit direction for Instagram seeds.
  3. Look up the seed creator's contact data by calling the WaveInflu email-lookup endpoint and storing only API-returned values such as platform, username, normalized profile link, region, emails, contacts, and quota metadata.
  4. Request similar creators with the WaveInflu similar endpoint using the target platform, seed profile URL when supported, content direction when provided, and only the filters the user asked for.
  5. Preserve the API's similarity order, then deduplicate results by normalized profile URL, platform user ID, or channel ID while removing the seed creator from the recommendation set.
  6. Enrich each recommended creator with an email lookup, prefer the primary email or first unique email returned, and mark rows as Not found when no email exists or Lookup failed when the request errors.
  7. Normalize the final report by keeping exact numeric metrics in JSON, using compact display values only in Markdown, and clearly separating API facts from any operator assumptions.
  8. Return a concise deliverable in Markdown and JSON that includes the seed creator, discovery scope, similarity coverage, email coverage, quota notes, and a single evidence-based creator table.

KOL Creator Discovery Setup

  1. Install the required runtime dependencies: Python 3 and curl.
  2. Set your AIsa API key in the environment before running Openclaw Skills.
export AISA_API_KEY="your-aisa-api-key"
  1. Never print, log, or commit the API key. If the key is missing, prompt the user to configure AISA_API_KEY first.
  2. Run the bundled helper script from the skill folder.
python3 scripts/kol_creator_discovery.py research \
  "https://www.youtube.com/@mkbhd" \
  --limit 10 \
  --out kol-report.md \
  --json-out kol-report.json
  1. For targeted discovery, provide platform filters and audience constraints.
python3 scripts/kol_creator_discovery.py research \
  "https://www.tiktok.com/@creator" \
  --platform tiktok \
  --content-direction "consumer AI apps and productivity tools" \
  --regions US,GB \
  --languages en \
  --min-followers 10000 \
  --max-followers 500000 \
  --limit 15 \
  --out kol-report.md
  1. Use the helper modes for narrower tasks such as email lookup only or similar-creator discovery only.
python3 scripts/kol_creator_discovery.py lookup "https://www.instagram.com/onkimia/"
python3 scripts/kol_creator_discovery.py similar --platform youtube --seed-profile-url "https://www.youtube.com/@mkbhd" --limit 10
  1. Review references/api-reference.md before changing payload fields or interpreting API responses.

KOL Creator Discovery Data Schema & Taxonomy

Openclaw Skills organizes data around a seed profile, API enrichment results, and a final outreach report.

Data object Source Key fields Purpose
Seed input User-provided profile URL profile URL, inferred platform, optional content direction Starting point for discovery
Discovery filters User-provided options platform, limit, regions, languages, follower range, average-view range Narrow and rank the recommendation set
Email lookup response POST /apis/v1/waveinflu/email-lookup platform, username, normalized profile link, region, emails, contacts, quota metadata Verify contact data and normalize creator identity
Similar creators response POST /apis/v1/waveinflu/similar creator profile URL, similarityScore, follower counts, average views, region, language Generate ranked creator recommendations
Output report references/report-template.md + helper script seed summary, scope, coverage, table rows, quota notes Human-readable deliverable for outreach review
JSON export --json-out exact counts, exact metrics, lookup status, deduped results Machine-readable archive for downstream automation

Output file conventions

  • kol-report.md: primary Markdown report with the seed creator, coverage notes, and a concise table.
  • kol-report.json: structured export for automation, CRM import, or QA.

Metadata taxonomy

  • role: Seed or Similar
  • rank: API order after deduplication
  • creator: display name or handle
  • platform: YouTube or TikTok
  • profile_url: normalized creator profile link
  • similarity_score: WaveInflu ranking score
  • followers and average_views: exact values in JSON, compact display in Markdown only
  • region and language: preserve API values or when missing
  • email: primary email, first unique email, Not found, or Lookup failed
  • lookup_status: success, Not found, or Lookup failed

KOL Creator Discovery Advanced Features

  • Seed-to-prospect enrichment that combines creator discovery with verified contact lookup
  • Similarity ranking preserved exactly as returned by WaveInflu, then deduplicated safely
  • Quota-aware batching that warns before enriching more than 25 creators
  • Dual-output workflow with Markdown reporting and JSON export for automation
  • Conservative data handling that never invents emails or fabricates missing metrics
  • Graceful failure handling that continues processing even if one creator lookup fails
  • Instagram-compatible workflows when content direction is explicitly provided
  • API-sourced evidence tracking so operators can verify every row before outreach
  • Openclaw Skills compatibility across multiple agent runtimes that support skill folders

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*