tikhub-api-helper

The TikHub API Helper is a professional-grade Claude Code Agent Skill designed to streamline the discovery and utilization of TikHub RESTful APIs. It serves data scientists, marketers, researchers, and developers who need to aggregate social media intelligence from multiple global platforms. By providing a unified interface to search, validate, and execute requests against TikHub’s massive endpoint library, this skill eliminates the manual overhead of traversing complex API documentation.

The skill enables seamless interaction with major social ecosystems including TikTok (Web/App), Douyin, Xiaohongshu, Instagram, YouTube, Twitter, Reddit, and Bilibili. Whether you are analyzing trending hashtags, retrieving user profile metadata, scraping comments, or monitoring billboard statistics, the helper provides a structured workflow. It intelligently processes search queries to identify relevant API paths, verifies required parameters, and executes the requests, returning clean and formatted data directly to your environment.

• Advanced API discovery: Search by keyword, tag (e.g., TikTok-Web-API), or category to find specific endpoints within the comprehensive OpenAPI specification.

• Parameter guidance: Automatically identify required fields, path parameters, and body structures to ensure successful API calls.

• Cross-platform support: Unified tools for retrieving data from over 12 diverse social platforms, handling both Chinese and English language queries effortlessly.

• Execution environment: Built-in support for secure API token management and automatic switching between China-based (api.tikhub.dev) and international (api.tikhub.io) base URLs to bypass regional connectivity restrictions.

• Ensure the presence of the required openapi.json file within the skill directory for full indexing capabilities.

• Usage involves a simple four-step cycle: search for an endpoint, review the detailed parameters, execute via the client, and parse the resulting JSON data.

• Note that endpoints are subject to a 10 requests-per-second (QPS) rate limit per path; implement appropriate delays if executing high-volume data collection tasks.

• Authentication requires a valid TIKHUB_TOKEN environment variable; for local development, you may configure the default token within the client script.