tiktok-teneo — Claude Code skill: TikTok data via Teneo CLI
Pulls video metrics, creator profiles and hashtag posts through the tiktok agent in Teneo CLI. Handy when you need to break down someone's videos or watch a hashtag grow.
npx skills add TeneoProtocolAI/teneo-skills --skill tiktok-teneo -a claude-code
npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a claude-codeWhat tiktok-teneo does
The skill does not scrape TikTok on its own. What it hands the agent is the exact command syntax and per-query pricing for the tiktok agent in Teneo CLI, and you run those commands in a terminal. Three retrieval modes exist: video takes a link and returns metadata for that clip, profile takes a username and returns public profile data, hashtag returns however many posts you ask for. A fourth command, help, lists everything.
Results arrive as JSON, with the readable version sitting in the humanized field. Queries cost money: video and profile run $0.0075 per query, while hashtag charges $0.0075 per item, so the bill scales with the number of posts you request. Payment is in USDC on Base, Peaq or Avalanche, which means a funded wallet on the right chain has to be in place first.
The CLI itself is a one-time install, and nothing works without it: commands like ~/teneo-skill/teneo command "tiktok" ... fail until the binary exists. To see whether it is there, run test -f ~/teneo-skill/teneo && ~/teneo-skill/teneo --version || echo "NOT_INSTALLED". Every command also requires the --room <roomId> flag.
What it helps with
- pull metrics for one video from its URL
- check a creator's reach and engagement before a deal
- export hashtag posts to study a trend
- grab captions and publish timestamps for clips
- compare several creators by the numbers
Example prompts for the agent
- Get the metadata for this video through tiktok:
~/teneo-skill/teneo command "tiktok" "video <url>" --room <roomId> - Pull the profile for this username and show follower and like counts
- Fetch 50 posts for the hashtag and list the most common captions
How to install tiktok-teneo
1Skills CLI (Vercel)
npx skills add TeneoProtocolAI/teneo-skills --skill tiktok-teneo -a claude-codenpx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a claude-code2Manually: put the files in place
~/.claude/skills/teneo-agent-tiktok/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/teneo-agent-tiktok/
1Skills CLI (Vercel)
npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a codex2Manually: put the files in place
.agents/skills/teneo-agent-tiktok/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a cursor2Manually: put the files in place
.cursor/skills/teneo-agent-tiktok/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TeneoProtocolAI/teneo-skills teneo-agent-tiktok2Manually: put the files in place
.github/skills/teneo-agent-tiktok/SKILL.md1Skills CLI (Vercel)
npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a gemini-cli2Platform CLI
gemini skills install https://github.com/TeneoProtocolAI/teneo-skills --path skills/agents/teneo-agent-tiktokManually: put the files in place
.devin/skills/teneo-agent-tiktok/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tiktok-teneo
How do I install tiktok-teneo in Claude Code?
Run npx skills add TeneoProtocolAI/teneo-skills --skill tiktok-teneo -a claude-code, then add the agent itself with npx skills add TeneoProtocolAI/teneo-skills --skill teneo-agent-tiktok -a claude-code. The skill file lands at ~/.claude/skills/teneo-agent-tiktok/SKILL.md.
What does tiktok-teneo do?
It supplies the live commands, arguments and pricing for the tiktok agent in Teneo CLI. Through them you get video metadata, profile details and hashtag posts.
What does a query cost?
video and profile are $0.0075 per query, hashtag is $0.0075 per item. The help command is free.
