tikhub-api-helper

TikHub API Helper 是一个辅助用户搜索、查找和调用 TikHub API 端点的技能，主要用于获取社交媒体数据。它提供两个核心脚本：api_searcher.py 用于搜索和发现相关 API，api_client.py 用于向 TikHub API 端点发起 HTTP 请求。

用途该技能适用于需要从多个社交媒体平台获取数据的场景，包括 TikTok、抖音、小红书、Lemon8、Instagram、YouTube、Twitter、Reddit、Bilibili、微博、知乎等。用户可以通过关键词或标签搜索可用的 API 端点，查看参数说明，并直接调用接口获取数据。

主要能力

API 搜索：支持按关键词搜索（如 "user profile"、"视频评论"、"trending"），按标签列出 API（如 tag:TikTok-Web-API），列出热门 API（popular），列出所有标签（tags），以及查看特定 API 的详细信息（detail:OPERATION_ID）。
API 调用：支持 GET 和 POST 请求，可传递查询参数或 JSON 请求体。例如获取用户资料、搜索视频、获取帖子详情、获取评论等。
多平台支持：涵盖 TikTok Web（58 个端点）、TikTok App（76 个端点）、抖音 Web（76 个端点）、抖音 App（45 个端点）、抖音搜索（20 个端点）、抖音 Billboard（31 个端点）、小红书 Web（26 个端点）、Instagram（26 个端点）、YouTube（16 个端点）、Twitter（13 个端点）、Reddit（23 个端点）、Bilibili（24 个端点）、微博（33 个端点）、知乎（32 个端点）。

使用方式

搜索相关 API：使用 api_searcher.py 脚本，例如 python api_searcher.py "user profile" 或 python api_searcher.py tag:TikTok-Web-API。
查看 API 详情：使用 python api_searcher.py detail:tiktok_web_fetch_user_profile_get 获取参数信息。
调用 API：使用 api_client.py 脚本，例如 python api_client.py GET /api/v1/tiktok/web/fetch_user_profile "sec_user_id=MS4wLjABAAAA..." 或 python api_client.py POST /api/v1/tiktok/web/generate_xgnarly '{"url": "https://..."}'。
认证：API 请求默认使用开发用 Token。生产环境建议从 TikHub User 获取 API Token，设置 TIKHUB_TOKEN 环境变量，或修改 api_client.py 中的 DEFAULT_TOKEN。请求头格式为 {"Authorization": "Bearer YOUR_API_TOKEN"}。
Base URL：中国用户使用 https://api.tikhub.dev（绕过 GFW），国际用户使用 https://api.tikhub.io。API 客户端会自动检测合适的 URL，也可通过修改 use_china_domain 参数覆盖。

适用场景

限制

速率限制：每个端点每秒 10 次请求（QPS）。
超时：30-60 秒。
重试：出错时最多重试 3 次。
常见错误包括 401 Unauthorized（检查 Token）、429 Too Many Requests（等待后重试）、连接错误（检查网络，中国大陆可尝试中国域名）、缺少参数（查看 API 详情）。
具体各平台 API 的可用性、参数和返回格式需参考 TikHub API 文档。

参考资源

技能介绍