SuperAPI AI 工具集

weibo-realtime-search

通用与其它

查看项目

更新于 10-16 04:41

技能介绍

用途

微博作品搜索工具用于根据关键词调用 Redfox 接口搜索微博博文,帮助用户发现指定方向或领域的微博内容与博主。当用户需要搜索微博内容、查找微博热门博文时使用。触发词包括:微博搜索、搜微博、微博热门、微博博文、微博账号搜索。

主要能力

  • 关键词搜索:根据关键词搜索微博博文,用于发现目标赛道的内容。
  • 搜索类别:支持综合排序(1)、热门排序(60)、实时排序(61)三种类别,按不同维度发现内容。
  • 认证筛选:支持普通用户(0)、个人认证(黄V,2)、机构认证(蓝V,3)过滤,用于精准筛选博主。
  • 智能拓展:无结果时自动生成 10 个扩展词,突破搜索瓶颈发现相关内容。
  • 分页浏览:支持多页结果浏览。
  • 订阅推送:支持关键词每日推送,定时获取最新搜索结果。

鉴权与配置

获取 API Key:需前往红狐hub 获取 API KEY(具体获取方式资料未详细说明)。

配置 API Key 有两种方案:

方案1:以 Qoder 为例,将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中:

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

方案2:终端配置:

export REDFOX_API_KEY="ak_xxxx..."

使用方式

Step 1:理解用户意图,提取关键词和筛选参数。优先提取 2~6 字的细分关键词;若用户意图模糊,需主动询问方向或领域,不得在用户未提供关键词时擅自猜测调用脚本。筛选参数在用户未指定时使用默认值:搜索类别默认 1(综合);页码默认 1;认证类别默认不传(不过滤)。

Step 2:调用搜索脚本:

python3 ~/.agents/skills/weibo-search/scripts/search_weibo.py "<关键词>" [--search-type 搜索类别] [--page 页码] [--ext-param 认证类别]

参数说明:keyword 为搜索关键词(任意字符串);--search-type 可选 1 / 60 / 61,对应综合排序 / 热门排序 / 实时排序(默认1);--page 为页码,从1开始(默认1);--ext-param 可选 0 / 2 / 3,对应普通用户 / 个人认证 / 机构认证(默认不传)。

脚本以 JSON 格式输出,包含字段:articles(关键词匹配博文列表)、search_type_label(本次搜索类别文字说明)、ext_param_label(本次认证类别文字说明)、page(当前页码)、has_next(是否有下一页)。每条博文包含字段:title(博文内容,取自API text 字段)、author(博主名称)、like_count(点赞数)、comment_count(评论数)、share_count(转发数,取自API forwardNum 字段)、work_url(博文链接)、publish_time(发布时间)、follower_count(粉丝数)。

Step 3:判断结果并展示。有匹配结果时,告知查询范围并渲染 Markdown 表格,数字按规则格式化(< 10000 为原始数字,≥ 10000 为 x.xw 格式),标题超过 30 字截断并加 ...,标题为空时显示 -;随后输出搜索类别与认证筛选提示,以及翻页提示。无匹配结果时输出抱歉提示与固定 10 个扩展词(2~6 字,英文逗号分隔),随后输出搜索类别与认证筛选提示。

Step 4:全部内容展示完毕后,附上订阅提示,询问是否订阅该关键词的每日推送(每天 09:00 自动推送最新博文)。

Step 5:用户回复「确认订阅」时创建定时任务。优先使用平台内置定时任务能力,若无则提供通用方案。

平台内置定时任务(优先):任务名称为「微博搜索订阅 - <关键词>」,执行频率为每天 09:00(cron:0 10 * * *),执行内容为运行脚本并按 Step 3~4 格式展示推送到当前对话。

通用配置方案(Linux/macOS crontab):

0 10 * * * python3 ~/.agents/skills/weibo-search/scripts/search_weibo.py "<关键词>"

创建成功后告知用户已成功订阅关键词的微博博文推送,每天 09:00 将自动查询最新数据并通知。

适用场景

  • 需要搜索特定关键词或领域的微博博文时。
  • 需要按热门、实时等维度查找微博内容时。
  • 需要按认证类型筛选优质博主时。
  • 需要持续跟踪某关键词最新微博并每日获取推送时。

限制

资料未提供关于调用频率、可用量、结果条数上限、收费与价格、支持的运行环境范围等信息,暂未提供。