用途:该技能通过 KeyAPI MCP 服务完成 TikTok 达人调研全流程,包括按关键词或地区发现达人、获取资料与表现指标、分析历史增长轨迹,以及基于排名数据做对比。适用于品牌合作或联盟营销选人、达人粉丝增长与互动率审计、直播 GMV 历史评估、竞品情报与市场定位分析。
主要能力:提供多个分析节点,如 search_influencers(关键词发现)、get_influencer_detail(身份与 ID 解析)、influencer_list_analytics(按互动率、GMV、粉丝、销量筛选)、influencer_detail_analytics(多维表现审计)、influencer_trends_analytics(增长趋势)、influencer_videos_analytics(视频内容表现)、influencer_livestreams_analytics(直播电商)、influencer_products_analytics(带货商品)、influencer_ranking_analytics(排名对比),以及获取最新视频、粉丝、关注、地区分布、二维码、里程碑等节点。
使用方式:需 Node.js v18 以上,设置环境变量 export KEYAPI_TOKEN=your_token_here,在技能目录运行 npm install 安装 @modelcontextprotocol/sdk。MCP 服务器地址为 https://mcp.keyapi.ai,认证头为 Authorization: Bearer $KEYAPI_TOKEN。可用 node scripts/run.js --list-tools 验证连接,用 --schema <tool_name> 查看输入结构,用 --tool <tool_name> --params '<json_args>' 调用,支持 --all-pages、--no-cache 等参数。结果会缓存到本地 .keyapi-cache/ 目录。
限制与规则:所有 *_analytics 端点使用 page_num(从 1 开始)和 page_size(最大 10);get_influencer_videos、get_influencer_followers、get_influencer_following 使用基于游标的 offset 分页。需区分 unique_id(公开 @handle)与 user_id(永久数字 UID),必要时先调用 get_influencer_detail 解析。响应 code=0 为成功,500 可短暂等待后重试一次,429 需等待 60 秒。图片 URL 若来自指定域名需批量转换。具体收费、价格与平台覆盖范围暂未提供。