Agent skill

TikHub API Helper

by liangdabiao in liangdabiao/tikhub_api_skill

Searches TikHub's social media API endpoints and calls them from the command line for TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Reddit and more.

No licenceAuto-check passedBackend & APIs

Install TikHub API Helper

skills CLI
$ npx skills add liangdabiao/tikhub_api_skill --skill tikhub-api-helper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install liangdabiao/tikhub_api_skill tikhub-api-helper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/liangdabiao/tikhub_api_skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tikhub-api-helper .claude/skills/tikhub-api-helper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tikhub-api-helper
GitHub stars
129
Token cost
~1.5k tokens
SKILL.md length
401 words
Files
4
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Searches TikHub's social media API endpoints and calls them from the command line for TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Reddit and more.

  • Works in 4 steps: Search for relevant APIs using the… → Show the user available options with… → Call the API with appropriate parameters → …
  • Fetching a TikTok or Douyin user profile or video details through TikHub
  • SKILL.md covers Quick Start, Available Scripts, Supported Platforms and Common Use Cases, plus 6 more sections
  • Runs Python scripts from its folder; calls python; reaches api.tikhub.io and api.tikhub.dev; needs TIKHUB_TOKEN and DEFAULT_TOKEN

What it does

This skill helps find and call TikHub API endpoints, which expose social media data for platforms including TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Twitter, Reddit, Bilibili, Weibo and Zhihu. Two Python scripts do the work: api_searcher.py searches an included OpenAPI description by keyword, in English or Chinese, or lists the tags, and api_client.py sends requests to the chosen endpoint.

The flow is to search for relevant endpoints, show you the options and parameters, call the API and return formatted results. Examples cover fetching a user profile, post details, search results and comments, and a health check needs no authentication while other calls do. A table lists endpoint counts per platform tag, for example 58 for TikTok Web and 76 for Douyin Web.

When your agent uses it

  • Fetching a TikTok or Douyin user profile or video details through TikHub
  • Searching TikHub endpoints by keyword in English or Chinese
  • Pulling comments or search results from a social platform's API
  • Listing which platforms and endpoint categories TikHub covers

Example prompts

  • “Find the TikHub endpoint for fetching a TikTok user profile and call it for this user ID.”
  • “Search the TikHub API for Xiaohongshu note search endpoints.”
  • “List the TikHub API tags so I can see which platforms are covered.”

Requirements

  • Python to run api_searcher.py and api_client.py
  • A TikHub API key for authenticated endpoints

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Search for relevant APIs using the searcher script
  2. Show the user available options with parameters
  3. Call the API with appropriate parameters
  4. Return formatted results to the user

What it can do on your machine

Read from SKILL.md and the folder at commit 95b2a10. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.tikhub.io
    • api.tikhub.dev

    Also links to:

    • tikhub.io
    • docs.tikhub.io
    • monitor.tikhub.io
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TIKHUB_TOKEN
    • DEFAULT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

TikHub API Helper loads about 1.5k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 401 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 401 words (~1,461 tokens).

“A skill to help users search, find, and call TikHub API endpoints for social media data.”

— opening of SKILL.md by liangdabiao
name
tikhub-api-helper

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in .claude/skills/tikhub-api-helper of liangdabiao/tikhub_api_skill.

  • SKILL.md
  • api_client.py
  • api_searcher.py
  • openapi.json

Open the folder on GitHubat commit 95b2a10

Compare with similar skills

TikHub API Helper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

TikHub API Helper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
TikHub API Helper this skillliangdabiao/tikhub_api_skill129—~1.5kAutomated safety check: PassNone
Video Publishgodot-fun/gai183—~2.6kAutomated safety check: PassMIT
Last30days CnJesseovo/last30days-skill-cn1.9k—~2.4kAutomated safety check: NotesMIT
Social Cover DirectorJamailar/Beav1.8k—~1.7kAutomated safety check: WarnCustom licence
Linkdigest Social Link Readersickn33/agentic-awesome-skills47k—~3.4kAutomated safety check: PassMIT
Influencer Discoverytigerless-labs/influencer-discovery212—~2.5kAutomated safety check: NotesNone

Similar skills

  • Video Publish

    godot-fun/gai

    From user materials, generates multi-platform video publish pack: Zhihu Chinese article, Reddit English post, 3 landscape + 3 portrait Google image-gen cover prompts, and title/description/tags for…

    183 GitHub stars~2.6k tokensUpdated today
    Media & CreativeAuto-check passed
  • Last30days Cn

    Jesseovo/last30days-skill-cn

    Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted…

    1.9k GitHub stars~2.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check: notes
  • A skill your agent uses when the user wants to plan or generate a social media cover image for a Xiaohongshu note, Douyin/TikTok photo post, Reels/Shorts cover, WeChat/Video Account post…

    1.8k GitHub stars~1.7k tokensUpdated yesterday
    Media & CreativeAuto-check: warnings
  • Linkdigest Social Link Reader

    sickn33/agentic-awesome-skills

    Read one public Xiaohongshu, Douyin, TikTok, YouTube, X or WeChat article link into text an agent can use (transcript, image text, key points) via the LinkDigest API or MCP server.

    47k GitHub stars~3.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Influencer Discovery

    tigerless-labs/influencer-discovery

    Find the bloggers/creators who can help promote your work, capture their contact info, and append them to the target sheet in Google Sheets.

    212 GitHub stars~2.5k tokensUpdated 17 days ago
    Marketing & SEOAuto-check: notes
  • Comment Mining

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or…

    3.4k GitHub stars~1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes

Categories

Questions about TikHub API Helper

What does TikHub API Helper do?

Searches TikHub's social media API endpoints and calls them from the command line for TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Reddit and more. This skill helps find and call TikHub API endpoints, which expose social media data for platforms including TikTok, Douyin, Xiaohongshu, Instagram, YouTube, Twitter, Reddit, Bilibili, Weibo and Zhihu.py sends requests to the chosen endpoint.

When should I use TikHub API Helper?

TikHub API Helper fits situations like: fetching a TikTok or Douyin user profile or video details through TikHub; searching TikHub endpoints by keyword in English or Chinese; pulling comments or search results from a social platform's API; listing which platforms and endpoint categories TikHub covers.

How do I install TikHub API Helper in Claude Code?

Run `npx skills add liangdabiao/tikhub_api_skill --skill tikhub-api-helper -a claude-code`. Or copy the skill folder (.claude/skills/tikhub-api-helper in liangdabiao/tikhub_api_skill) into .claude/skills/tikhub-api-helper in your project. Claude Code loads it when a task matches its description.

How do I install TikHub API Helper in Codex?

Run `npx skills add liangdabiao/tikhub_api_skill --skill tikhub-api-helper -a codex`. Or copy the skill folder (.claude/skills/tikhub-api-helper in liangdabiao/tikhub_api_skill) into .agents/skills/tikhub-api-helper in your project. Codex loads it when a task matches its description.

Can I use TikHub API Helper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add liangdabiao/tikhub_api_skill --skill tikhub-api-helper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tikhub-api-helper, .gemini/skills/tikhub-api-helper, .github/skills/tikhub-api-helper and .opencode/skills/tikhub-api-helper in your project.

What does TikHub API Helper need to run?

Going by SKILL.md and its folder, TikHub API Helper needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named TIKHUB_TOKEN and DEFAULT_TOKEN. Our summary lists: Python to run api_searcher.py and api_client.py; A TikHub API key for authenticated endpoints.

Does TikHub API Helper access the network?

SKILL.md names 6 domains. In commands or code: api.tikhub.io and api.tikhub.dev; the agent is likely to contact these when it follows the instructions. As links in the text: tikhub.io, docs.tikhub.io, monitor.tikhub.io and github.com. This is read from the text; nothing was executed.

Is TikHub API Helper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does TikHub API Helper use?

No licence was found for TikHub API Helper or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does TikHub API Helper use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to TikHub API Helper?

Skills that share tags, products or a category with TikHub API Helper: Video Publish (godot-fun/gai, 183 stars), Last30days Cn (Jesseovo/last30days-skill-cn, 1.9k stars), Social Cover Director (Jamailar/Beav, 1.8k stars) and Linkdigest Social Link Reader (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains TikHub API Helper?

liangdabiao (a GitHub user) maintains it in liangdabiao/tikhub_api_skill, which has 129 GitHub stars. The repository was last updated on July 8, 2026.

Source: liangdabiao/tikhub_api_skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.