MCPInstall

kalodata

by sailtonightMarketing & SEO

Use for TikTok Shop market data: trending products, top creators, shop/product sales and revenue, viral videos, livestreams, category rankings — 选品、带货达人、 店铺/商品销量、爆款视频、直播带货、TikTok 小店数据. Answers come from KaloData via the bundled kalo CLI (Python, zero install). Use whenever the user researches TikTok Shop, even if they never say "kalodata".

Installs
87
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/sailtonight/kalodata-skill --skill kalodata
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads kalodata automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

KaloData TikTok Shop analytics (kalo)

TikTok Shop e-commerce analytics from KaloData — rankings and details for products, shops, creators, videos, livestreams and categories.

Run

The CLI ships inside this skill (scripts/kalo.py, Python 3.11+ stdlib only — nothing to install):

python3 <this-skill-dir>/scripts/kalo.py product rank --region US

All examples below write kalo as shorthand for python3 <this-skill-dir>/scripts/kalo.py.

Output is TOON (token-oriented) on stdout; add --json to any command for raw JSON. Errors are structured on stdout with actionable help: lines. Exit codes: 0 ok, 1 error, 2 usage.

Setup — check this before the first query

Every command needs a KaloData API key (sent as the secret-key header). Before the first query of a session run kalo config and look at api_key. If it says missing, stop — don't guess a key and don't retry the query. Walk the user through these three steps and wait:

  1. Get a key — sign in at https://www.kalodata.com/open-center/account and click generate key. No account yet? Register at https://www.kalodata.com/open-center/home first. If they already call the KaloData API on credit-based billing, that same key works here — no new key needed.

  2. Save it — kalo config set --key <API_KEY> (stored in ~/.config/kalodata/config.toml, mode 0600), or set KALODATA_API_KEY in the environment.

  3. Credits — every query spends Kalo Credits. Measured costs per call:

    callcredits
    any rank or detail lookup0.2
    product images0.01
    creator images0.1
    product specs0.1
    video url0.5
    product comments (only when the upstream cache refreshes)1
    credit balance, credit logsfree

    Costs were measured against production; rank/detail lookups bill 0.2 flat under this skill's source-type: SKILL header. A playbook fans out into many calls, so it lands at 1–2 credits. kalo credit shows the remaining balance; top up at https://www.kalodata.com/pricing.

Don't announce or ask about credit costs for queries the user asked for — just run them. Bring up cost only when the balance may not cover a big fan-out (a data-gathering playbook, dozens of detail lookups: check kalo credit first), or when the user asks.

Commands

commandwhat
kalo product ranktop products; --category --keyword --price --launch --shop --creator
kalo product detail <id...>price range, shop id, revenue trend, product description
kalo product comments <id...>review insight: pain points, positives, usage scenarios (1 credit per refresh)
kalo product specs <id...>selling points (highlights) and spec attributes; --lang zh-CN translates
kalo product images <id...>product gallery image URLs
kalo shop ranktop shops; --type BRAND|RETAILER --keyword
kalo shop detail <id...>revenue split, top product ids
kalo creator ranktop creators; --followers --engagement --product
kalo creator detail <id|@handle...>contact email/handle, GPM, trend; handle match is fuzzy — verify the returned creator_handle
kalo creator images <id...>avatar URLs, up to 100 creator ids
kalo video ranktop shoppable videos; --product --creator --keyword --ai
kalo video detail <id...>full video metrics + trend
kalo video url <id...>playable mp4 URLs
kalo live ranktop livestreams; --keyword
kalo live detail <id...>viewers, GPM, top product ids
kalo category ranktop categories; --level 1|2|3
kalo category detail <id...>category revenue split + trend
kalo category search <kw>resolve category ids by keyword
kalo creditremaining credit balance for this key
kalo credit logswhat credits were spent on; --range --type --page
kalo configshow/set credentials and defaults

Conventions

  • All list commands take --region --range --page (1-5) --limit (5-100) --sort --asc --fields --json
  • Regions: US GB ID TH VN PH MY SG JP MX DE IT FR ES BR; ranges like last7Day, last30Day, yyyy-MM, or yyyy-MM-dd~yyyy-MM-dd
  • Numeric ranges are "min-max" with both ends numeric, e.g. --revenue 1000-50000
  • Add --images on product/shop rank or product detail to include image URLs; creator avatars come from kalo creator images (creator rank has no image column)
  • Signed media URLs (product images, creator images, video url) expire about 5 minutes after the call — hand them to the user or download them now, never cache them
  • Run kalo <command> --help for per-command flags and examples

Typical flows

  • Trending research: kalo product rank --region US --range last7Day → kalo product detail <id> → kalo video rank --product <id>
  • Creator scouting: kalo creator rank --category <id> --followers 10000-1000000 → kalo creator detail <id> (has contact email)
  • Category drilldown: kalo category search "beauty" → kalo category detail <id> → kalo shop rank --category <id>

Playbooks

For complex analysis — product/creator diagnosis, category sourcing research, creator recommendation, viral-video methodology, shot-by-shot script writing — read references/playbooks.md first and follow its mandatory steps (always benchmark against same-category / same-price-band / same-follower-tier peers before drawing conclusions).

FAQ

What does the kalodata skill do?

Use for TikTok Shop market data: trending products, top creators, shop/product sales and revenue, viral videos, livestreams, category rankings — 选品、带货达人、 店铺/商品销量、爆款视频、直播带货、TikTok 小店数据. Answers come from KaloData via the bundled kalo CLI (Python, zero install). Use whenever the user researches TikTok Shop, even if they never say "kalodata".

How do I install kalodata?

Run npx skills add https://github.com/sailtonight/kalodata-skill --skill kalodata in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/kalodata/ (personal) or .claude/skills/kalodata/ (project).

Which AI agents can use kalodata?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is kalodata safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains kalodata?

It is published by sailtonight in sailtonight/kalodata-skill. It has 87 recorded installs.

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO453.7K installs