linkfox-tsearch-search

搜索实时网络信息并提取结果页面正文,用于近期新闻、热点趋势、当前事实核实、Reddit 等社区讨论、外部站点帖子、产品评价及竞品或品牌调研。用户需要获取当前外部网络信息时适用,无需明确说“搜索”。不适用于内部数据库或结构化数据集查询、本地上传文件分析、已有数据计算转换、无需外部资料的创作或 Amazon ABA 数据查询。

SKILL.md

GitHub

网页搜索与在线信息检索

适用范围

适用

检索当前外部网络信息,并根据搜索结果中已提取的页面正文直接概述。 用户表达“查一下”“了解一下”或“调研”时,先判断其需要的是当前网络信息,还是内部数据、历史数据库或本地文件。

场景速查

用户表达 查询场景
搜索一下、查找资料、Google 一下 直接网页搜索或一般信息检索。
最近有什么新闻、今天发生了什么 近期新闻与突发事件。
Reddit 上大家怎么评价、外站有哪些热门帖子 社区讨论、论坛帖子及用户观点。
现在流行什么 社交媒体热点与趋势。
核实目前价格或最新事实 实时数据查询与事实核实。
找产品或服务的评价 公开评价与使用体验。
调研竞品或比较品牌 从公开网页获取竞争信息。

边界

内部数据库、结构化数据集和 Amazon ABA 数据应使用对应数据查询工具;本地文件分析、已有数据计算转换及无需外部资料的创作不属于本技能范围。

前置条件

确定用户要核实的主题,以及必要的年份、地区、站点和目标语言。完整参数与使用限制见 references/api.md。

搜索与内容提取流程

  1. 围绕用户问题组织明确的搜索关键词,按需加入年份、地区、领域或社区名称。
  2. 执行搜索;工具会在同一次调用中搜索并自动提取靠前结果的页面正文。
  3. 按 references/api.md 判断响应,阅读已提取正文并直接概述,结合来源标题、链接和时效回答用户。
  4. 多角度调研可分别组织不同关键词,按用户范围和成本约束继续。空结果或内容不相关时,提出更具体的替代搜索词,不自动连续试探。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/tsearch_web_search.py '<JSON 参数>' [--inline]。
  • 成本约束:每次接口请求消耗 6 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <输出根目录>/<YYYY-MM-DD>/<session>/data/linkfox-tsearch-search-<timestamp>.json。输出根目录优先选择 ACPX_WORKSPACES 第一个路径下可写的 linkfox/,其次选择 <cwd>/linkfox/;<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp;请求前检查输出目录及响应文件是否可创建,预检失败时报错退出,不发请求。详见 references/api.md。
  • 序列化后的响应体不超过 8000 个 UTF-8 字节:保存后,将完整 JSON 打印到标准输出。
  • 序列化后的响应体超过 8000 个 UTF-8 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

6 算力 / 次

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 搜索与正文提取一体完成:结果已经包含页面内容,不再对这些结果另行调用浏览器或网页提取工具。
  • 直接概述正文:正文是非结构化文本,给出清晰简洁的归纳,不倾倒原文,不送入数据分析沙箱,也不做 SQL 式处理。外层 JSON 仅用于读取结果和来源。
  • 逐项注明来源:展示每条结果的页面标题与 URL,便于用户核实。
  • 公平呈现观点:结果包含不同观点时,如实呈现,不把社区讨论当作一致结论。
  • 说明信息时效:指出内容是否较新或可能过时,不将缓存结果描述为刚获取的信息;缓存与刷新约定见 references/api.md。
  • 提高搜索精度:使用具体主题和组合词,例如产品型号与“电池续航评测”;自然语言问题和关键词短语均可,按目标内容选择英文或对应语言。
  • 解释空结果:无结果或内容不相关时,建议细化关键词并给出备选表达,继续调用遵守成本约束。
  • 区分文件缓存与数据库:搜索结果不写入数据库供后续查询;脚本的本地 JSON 落盘与缓存用于复用本次结果。

使用示例

场景 搜索关键词示例
近期新闻 latest AI regulation policy 2026
产品评价 best robot vacuum cleaner under $300 Reddit
技术资料 Python asyncio tutorial beginner guide
社区讨论 Reddit best budget mechanical keyboard 2026
热门话题 trending topics on social media this week
实时数据核实 current Bitcoin price USD
品牌比较 Anker vs Baseus portable charger comparison

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。