> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> ## Agent Instructions (AIsa)
>
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt
# KOL Creator Discovery
> Find creator emails and similar YouTube or TikTok creators from a single profile URL, returning an outreach-ready table.
[View on GitHub â](https://github.com/AIsa-team/agent-skills/tree/main/marketing/kol-creator-discovery)
**Creator prospecting for agents.** Provide the skill with a TikTok, Instagram, or YouTube profile URL. It looks up that creator's contact email, finds similar YouTube or TikTok creators via AIsa's WaveInflu APIs, retrieves an email for each match, and returns an evidence-based Markdown table (plus optional JSON).
## Install
```bash npx skills theme={null}
npx skills add AIsa-team/agent-skills --skill kol-creator-discovery
```
```bash AIsa CLI theme={null}
npm install -g @aisa-one/cli
aisa skills install kol-creator-discovery
```
Start a new agent session after installing so the skill loads.
## What can agents do with it?
"Find the contact email for this Instagram creator profile."
"Find 15 YouTube creators similar to this channel and include their emails."
"Find US and UK TikTok creators in this content direction with 10Kâ500K followers."
A single table with profile URL, similarity score, followers, average views, region/language, email, and lookup status.
## Requirements
```bash theme={null}
export AISA_API_KEY="your-aisa-api-key"
```
* Python 3 and `curl`
* Calls go only to `https://api.aisa.one/apis/v1/waveinflu/...`. No separate WaveInflu credentials are needed.
Each email lookup and similar-creator search is a separate billed call. The skill enriches 10 creators by default and asks for confirmation before enriching more than 25.
## Compatibility
Works with any agentskills.io-compatible harness, including Claude Code, Claude, OpenAI Codex, Cursor, Gemini CLI, OpenCode, Goose, OpenClaw, Hermes, and other runtimes that support skill folders.
## Quick start
```bash theme={null}
python3 scripts/kol_creator_discovery.py research \
"https://www.youtube.com/@mkbhd" \
--limit 10 \
--out kol-report.md \
--json-out kol-report.json
```
With a content direction and audience filters:
```bash theme={null}
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
```
## Commands
| Command | What it does |
| - | - |
| `research PROFILE_URL` | Full workflow: seed email lookup, similar-creator discovery, email lookup per match, and Markdown/JSON report |
| `lookup PROFILE_URL [...]` | Email lookup only, for one or more profile URLs |
| `similar --platform youtube\|tiktok` | Similar-creator discovery only (`--seed-profile-url` and/or `--content-direction`) |
Options for `similar` and `research`: `--platform`, `--content-direction`, `--limit` (1â100, default 10), `--regions`, `--languages`, `--min-followers`, `--max-followers`, `--min-average-views`, `--max-average-views`. `research` requires `--allow-large-enrichment` for more than 25 email lookups.
## How it works
1. **Validate the brief.** The seed must be a creator profile URL, not a post or video. The target platform is inferred from a YouTube or TikTok seed. Instagram seeds require an explicit `--platform` and `--content-direction`, because similarity matching does not accept Instagram profiles.
2. **Look up the seed creator** with `POST /apis/v1/waveinflu/email-lookup`.
3. **Find similar creators** with `POST /apis/v1/waveinflu/similar`, which returns creators sorted by `similarityScore`.
4. **Enrich each match** with its own email lookup. A missing email is recorded as `Not found` and a failed lookup as `Lookup failed`. The skill never guesses or pattern-matches an address.
5. **Deduplicate and report**, preserving WaveInflu's similarity order and exact metrics in the JSON output.
## When to use
* KOL or influencer research and prospecting
* Creator email lookup from a profile URL
* Building a similar-creator or outreach list for a campaign
The skill does not send outreach, email anyone, or upload the list anywhere without your separate authorization. Treat returned contact data as sensitive.
## Get started
1. Sign up at [aisa.one](https://aisa.one) and create an API key in the console.
2. Set it in your shell: `export AISA_API_KEY="your-key"`.
3. Install the skill with one of the commands under [Install](#install), then start a new agent session.
## Related
Creator emails and normalized profile details.
Similar YouTube or TikTok creators from a seed or content direction.
Turn a shortlist into a partnership pilot, brief, and measurement plan.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.