SuperAPI AI 工具集

marketing-data-access

营销与增长

查看项目

更新于 10-27 11:24

技能介绍

该技能的作用是统一说明如何访问外部公开营销数据与模型服务,主要入口是 GooseWorks 代理。按资料描述,客户不需要供应商账号或密钥,GooseWorks 按调用扣除积分。

一、用途分类

  1. 定向数据请求:当只需要帖子列表、互动排名或声音(voices)列表时,读取 focused-reads.md,直接返回所请求的数据,而不输出完整营销报告或日历;只使用相关接口参考,并保留日期、精确指标与覆盖范围。
  2. 托管营销数据:当工具列表中存在 marketing_data_describe 与 marketing_data_lookup 时,可用于精选人物/公司搜索与补充信息、工作邮箱查找与验证、LinkedIn 帖子互动者、域名 SEO 指标。Describe 免费并返回当前操作 schema;Lookup 默认给出免费报价:保留请求、展示报价的最高积分、经 spend-gate 分支 A 审批后,用与请求绑定的报价令牌和已批准上限执行。需读取实际结果与扣费后再声明覆盖范围。不同操作含义不同:总访问量不等于自然流量,查找器不等于邮箱验证,帖子数量不等于互动人数。分页 LinkedIn 结果需保留返回的续页令牌并遵循实时 schema,不得把后续页当作新搜索,也不得虚构供应商回执。重试前须阅读每次部分失败的凭据与费用。不支持任意供应商路径、个人邮箱或电话查询。
  3. 若上述工具不存在,改用公开页面、现有只读连接器或提供的导出数据,并标注缺失字段;不要要求客户去获取供应商密钥。

二、原始供应商调用

  • gooseworks:data_call_provider:GET,用于公开社交与搜索数据(scrapecreators)、ElevenLabs 声音列表、fal 任务轮询;ScrapeCreators 读取为付费,结果会说明费用。
  • gooseworks:data_post_provider:POST,用于 fal 模型(图像、视频、转录)、ElevenLabs 语音与音乐、ScrapeCreators 批量读取;付费。
  • gooseworks:data_price_provider:在运行前为 fal 和 ElevenLabs 调用定价;免费、只读。 各工具的参数据其自身说明,本技能不重复。若有专用 GooseWorks 工具(ads_library_scrape、competitor_research、social_inspiration_search、photos_generate、video_*、ads_generate)适合任务,应优先使用,它们自带品牌、审核流程与计费闸门;原始代理仅用于这些工具未覆盖的场景。

三、ScrapeCreators 读取的选择 按问题选择接口:品牌投放的广告(Meta Ad Library 相关路径、/v1/google/ad、/v1/linkedin/ads/search、/v1/tiktok/ad-library/search);Google 某查询的排名(/v1/google/search,仅自然结果第一页,无 AI Overview、无 People-Also-Ask、无本地包);人们对某话题的讨论(Reddit、Twitter、Threads、TikTok、Instagram reels、YouTube、LinkedIn、Pinterest 的搜索接口);帖子与视频下客户评论(TikTok、Instagram、YouTube、Facebook 评论接口);品牌或创作者发布内容(Instagram、TikTok、YouTube、LinkedIn、Twitter 相关接口);公开视频转写(YouTube、TikTok、Instagram 转写接口);某 X 账号身份(/v1/twitter/profile 及 user-tweets);创作者身份与联系方式(Instagram/LinkedIn 资料、link-in-bio 读取);趋势内容(TikTok 趋势流、Instagram reels 趋势、YouTube Shorts 趋势、搜索建议与 typeahead);TikTok Shop 商品评价(/v1/tiktok/shop/product/reviews)。查询键、时效选项与分页见 spend-gate 技能的 proxy-endpoints.md,不得猜测键名。

四、无需代理的免费来源 优先使用宿主自身抓取,包括无浏览器的定时任务:Hacker News 的公开 Algolia 搜索 API(https://hn.algolia.com/api/v1/search?query=<terms>&tags=story,加 &numericFilters=created_at_i><unix> 限定近期);RSS/Atom 订阅源(博客、更新日志、新闻页的 /feed、/rss、/blog/rss.xml 或页面 head 中的 link rel=alternate);站点地图 /sitemap.xml 用于梳理页面类型(对比、替代、定价、用例页),无需爬取。

五、费用规则 所有付费调用经 spend-gate 技能:分支 A 用于定价调用(fal、ElevenLabs),分支 B 用于 ScrapeCreators 读取。另有两条:重试 fal 或 ElevenLabs 时复用同一 idempotency_key,避免重复扣费;先窄后宽,一次查询一页,仅当第一页回答不佳时扩大范围。

六、禁止事项 不得使用或索取任何供应商密钥(APIFY_API_TOKEN、FAL_KEY、APOLLO_API_KEY、ELEVENLABS_API_KEY、OPENAI_API_KEY 等);不得在查询或请求体中放置凭据或机密;不得把一种来源当作另一种来源呈现(例如自然 Google 结果不等于 AI 回答读取)。

七、数据不可达时 原始代理覆盖公开社交与搜索数据、fal 与 ElevenLabs;托管营销工具在部署后覆盖其列出的线索/联系方式与 SEO 操作。两者都不承诺未列出的指标、AI 回答引擎(ChatGPT、Perplexity、AI Overviews)、Search Console、页面速度数据、应用商店列表,或客户自有邮件、店铺与分析工具。遇到此类需求按顺序处理:使用宿主代理已有的客户自有账号只读连接器;使用宿主自身网页搜索、抓取或浏览器获取公开页面与新闻;用平实语言请人提供导出或截图;否则跳过该步骤并明确说明哪些内容未读取,绝不估算缺失数字。若缺失账户数据只能由营销人员提供,应直接说明所需导出与列名。若 GooseWorks 完全未连接,按 marketing-guide 技能 §1 第 1 步处理;本地模式仅用第 1–3 步,不做付费读取,并说明一次未读取的内容。