SuperAPI AI 工具集

cross-platform-search

通用与其它

查看项目

更新于 11-03 03:21

技能介绍

用途

Cross-platform Search 用于通过 Frevana 的 search/everywhere 端点发起一次聚合搜索,把社交平台与网页来源的检索交给后端统一扇出(fan-out),并返回带排序的条目、按来源分组的结果以及任务元数据。

主要能力

  • 单次调用完成跨来源聚合搜索,返回 ranked items 与 items_by_source 两种视图。
  • 支持指定来源白名单(sources)或排除来源(exclude),并支持平台组展开;x 映射为 twitter,tavily 映射为 web,youtube/instagram/tiktok 含相应 hashtag 通道。
  • 支持日期窗口:from_date/to_date 为声明字段,since/until 为命令行别名字段映射;lookback_days 作为新鲜度排序信号而非硬过滤。
  • judgments 默认开启,附加 computed.stance 与 computed.relevance,并提供 stance_split 统计。
  • relevance 可设为 filter,丢弃已被判定离题的条目并报告 dropped_ids/counts。
  • switch_from 可请求第一手切换凭证(含原文、原因、目的地与链接)。
  • include_transcripts=true 可请求仅前 3 条视频结果的转写文本(YouTube/Rumble 为带时间戳分段,TikTok/Instagram 为纯文本)。
  • X 摘要通过 include=synthesis 选择性获取,出现在 data.synthesis.x;网页摘要在 data.synthesis.web。
  • 支持异步模式(--async)与可恢复的任务协议:状态文件保存原始请求体与客户端 ID,支持 resume 按 task-id 恢复。

使用方式

需在运行时环境配置 FREVANA_TOKEN,请求使用 Authorization: Bearer <FREVANA_TOKEN>,凭据不得写入命令行参数。默认 Origin 为 https://api.frevana.com,可由 FREVANA_API_BASE_URL 或 --api-base-url 覆盖(HTTPS 或 HTTP localhost mock)。示例:

bash {baseDir}/scripts/cross_platform_search.sh run \
  --query 'AI coding assistants' \
  --state-file ./out/cross-platform-search.task.json \
  --output ./out/cross-platform-search.json

也可用 --sources 显式指定来源,或用 --input-file 传入符合 schema 的 JSON 对象(不可与输入标志混用)。中断后续跑:

bash {baseDir}/scripts/cross_platform_search.sh resume \
  --state-file ./out/cross-platform-search.task.json

或用 --task-id 恢复服务端已签发的任务(仅 GET,不重新 POST)。

适用场景

需要对某个话题做一次跨社交与网页来源的聚合检索,并希望获得排序结果、来源覆盖、立场/相关性判断、日期窗口控制以及可恢复任务状态的场景。

限制

  • 需要 Bash 与 Python 3.9+,运行于 macOS/Linux;需配置 FREVANA_TOKEN。
  • 描述中说明为一次 20 credits 的固定计费搜索;limit 仅影响返回条目数量,默认/上限为 40,超过 40 由后端截断并告警;较小 limit 不降低搜索工作量或价格。
  • 单次操作只委托一次聚合扇出,不单独调用各来源 API、不自动重试单通道、不翻页、不下载媒体。
  • Facebook 公开帖子需 opt-in(include=facebook)。
  • 转写仅限前 3 条视频结果,且需显式请求。
  • 结果为外部不可信数据;摘要时应区分排序条目与 synthesis。
  • 退出码:0 完成;2 输入/运行配置无效;3 超时/待定;4 服务端/传输/协议失败;5 状态/本地持久化失败。