ae_zhihu_search_discover
获取知乎搜索发现推荐内容,无需提供输入参数。结果包含可用的发现数据,并可能附带状态、请求信息、生成时间、文档或缓存等响应元信息;具体数据字段以实际返回为准。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_zhihu_search_discover
获取知乎搜索发现推荐内容,无需提供输入参数。结果包含可用的发现数据,并可能附带状态、请求信息、生成时间、文档或缓存等响应元信息;具体数据字段以实际返回为准。
ae_zhihu_user_search
按关键词搜索用户。`keyword` 为必填项;`offset` 可选,用于设置起始位置,默认值为 `0`;`limit` 可选,用于设置每页用户数量,默认值为 `25`。接口同步返回结果,匹配内容位于 `data` 字段中,并附带响应元数据。
ae_kuaishou_app_live_search
### 用途 按关键词搜索当前正在直播的直播间,支持使用游标分页。 ### 输入参数 - `keyword`:必填,搜索关键词。 - `pcursor`:可选,分页游标。首次搜索时留空或省略;翻页时填写上一页响应中的 `pcursor`。 ### 返回结果 返回匹配关键词的直播间搜索结果;如需获取下一页,可继续使用响应中的分页游标。
ae_wechat_get_channel_info
## 微信视频号账号更多信息 获取指定账号的「更多信息」分区,包括基础信息(IP 归属地、资料所在地、视频号 sph 公开号)及认证信息(服务单位、主体类型、互联网新闻信息服务许可证编号、服务类别、认证时间)。具体信息以该账号实际返回的字段为准。 ### 输入 - `request_body`(必填):请求对象。 - `request_body.username`(必填):视频号 finder username,须匹配 `^v2_[0-9a-fA-F]+@finder$`,长度为 10–256 个字符。不能直接传昵称或 `sph…` 视频号 ID。可从视频详情或账号视频列表响应中的 `username` 字段取得;如果只有 sph 公开号,需先将其转换为 finder username。 - `request_body.raw`(可选,默认 `true`):`true` 返回原始响应;`false` 返回精简解析结构。 ### 返回含义 - `raw=false`:`$.data.finder_username` 为账号 finder username,`$.data.channel_id` 为 sph 公开号,`$.data.sections` 保留分区结构。`$.data.info` 是按「标题→内容」扁平化的字典,键名例如 `视频号ID`、`IP归属地`、`服务单位`、`主体类型`、`互联网新闻信息服务许可证编号`、`服务类别`、`认证时间`;解析时会剥离富文本图片标记。 - `raw=true`:`$.data.baseResponse.ret` 为结果状态,`0` 表示成功。分区标题位于 `$.data.sections[N].title`,条目标题及内容位于 `$.data.sections[N].items[M].title` 和 `.content`,条目还可能包含 `.type`、`.jumpInfo`。此模式不含扁平化 `info` 字典或独立的 `channel_id`,需要时应从分区条目中提取。 响应可能较慢,建议将客户端请求超时设置为 30 秒;超时是客户端设置,不是本工具的输入参数。
ae_wechat_search_channel_videos
在指定创作者的微信视频号内,按关键词搜索其已发布的视频。仅检索该账号,不进行全平台搜索;每次调用返回一页结果。 输入:在必填的 request_body 对象中提供以下字段。 - username(必填):创作者的 finder username,须匹配 ^v2_[0-9a-fA-F]+@finder$,长度为 10–256 个字符,不能用昵称代替。 - keyword(必填):搜索关键词,去除首尾空白后为 1–100 个字符。 - raw(可选,默认 true):true 返回原始分组搜索响应;false 返回精简、扁平化的命中列表。 - cursor(可选):首页省略或留空;后续页原样传入上一页响应的 next_cursor。该值为最长 4096 个字符的不透明字符串,也接受 null;不要解析、拼接或自行构造。 返回含义: - raw=false 时,data 包含回显的 username、keyword,本页命中数 count,命中数组 items,以及 continue_flag 和 next_cursor。命中项包含 type、doc_id、去除搜索高亮标记的 title;desc、thumb_url、username、nickname 可能为 null。 - raw=true 时,data.query 回显关键词,data.offset 表示下一页偏移;命中项位于 data.data[N].subBoxes[M].items 或 data.data[N].items。是否还有更多结果使用 data.continueFlag 表示,而非 data.continue_flag。 - 两种格式均提供 data.next_cursor。仅在对应的继续标志为 1 且 next_cursor 非空时,将其原样作为 cursor 再次调用获取下一页;没有下一页时 next_cursor 为 null。 注意:doc_id 等可能是超过 JavaScript 安全整数范围的 64 位整数,请使用支持大整数的 JSON 解析方式,将 ID 无损地按字符串接收和传递,不要经过 JavaScript Number。本工具不直接返回媒体下载地址或解码密钥,如需这些信息须另行查询视频详情。响应可能较慢,建议在客户端可配置时将超时设为 30 秒;timeout 不是本工具的输入参数。
ae_reddit_app_fetch_popular_feed
获取 Reddit 全站流行推荐内容,用于浏览热门或趋势帖子。 所有输入均为可选: - sort:排序方式,可选 BEST(默认)、HOT、NEW、TOP、CONTROVERSIAL、RISING。 - time:时间范围,可选 ALL(默认)、HOUR、DAY、WEEK、MONTH、YEAR。 - after:分页游标,默认空字符串,用于首次请求;有下一页时,使用返回的 after 游标继续获取。最长 4096 个字符。 - filter_posts:要排除的帖子 ID 列表,便于减少重复,默认为 []。最多 100 个;每个 ID 以 t3_ 开头,后接小写字母或数字,总长度为 4–20 个字符。 - language:首选返回语言标签,默认 en-US。长度为 2–16 个字符,以 2–3 个字母开头,可追加以连字符分隔、每段 2–8 个字母或数字的部分。 - need_format:是否请求清洗、格式化数据,默认为 false。 返回 JSON 响应,其中 data 载荷按文档说明包含热门帖子、标题、内容、点赞数和评论数等帖子详情,以及分页信息。响应定义未固定载荷的详细结构,data 也可能为 null;实际帖子字段和下一页游标以返回内容为准。 示例:{"sort":"HOT","time":"DAY","filter_posts":[],"after":"","language":"en-US","need_format":false}
ae_reddit_app_fetch_post_details_batch
按 ID 批量获取最多 5 条 Reddit 帖子的详情,可选择附带指定评论的上下文。 输入: - post_ids(必填):包含 1–5 个帖子 ID 的逗号分隔字符串,例如 "t3_1ojnh50,t3_1ok432f"。每个 ID 必须以 t3_ 开头,后接 1–17 位小写字母或数字;整个字符串最多 104 个字符。不要传入网址或数组。 - include_comment_id:设为 true 时,请求 comment_id 指定评论的上下文;默认 false。 - comment_id:需要评论上下文时,提供以 t1_ 开头、后接 1–17 位小写字母或数字的评论 ID;默认空字符串。 - need_format:是否清洗和格式化返回数据;默认 false。 - language:期望的响应语言,使用 IETF 语言标签,例如 en-US;长度为 2–16 个字符,默认 en-US。 返回:响应中的 data 承载帖子详情,可能包含标题、正文、作者、点赞及评论统计、所属版块、奖励、媒体资源和推荐原因等。文档未固定 data 的内部结构,data 也可能为 null,不能保证每条帖子都有上述全部信息。 限制:单次超过 5 条帖子会返回错误。必须保留帖子 ID 的 t3_ 前缀和评论 ID 的 t1_ 前缀。此工具用于查询已知 ID 的帖子,不用于搜索帖子,也不保证返回完整评论串。
ae_reddit_app_fetch_subreddit_info
获取指定 Reddit 版块的详细信息,例如版块描述、订阅人数、创建时间及规则(以实际可用信息为准)。 输入(均为可选): - subreddit_name:不带 r/ 前缀的版块名称,例如 "pics" 或 "AskReddit";长度为 2–21 个字符,仅允许英文字母、数字和下划线。默认值为 "pics"。 - language:期望的返回语言,使用 IETF 语言标签,例如 "en-US";长度为 2–16 个字符,且须匹配 ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$。默认值为 "en-US"。 - need_format:是否请求清洗和格式化数据,布尔值,默认为 false。 返回:JSON 响应,其中 data 承载版块元数据。文档未规定固定的数据字段,实际字段可能有所不同,data 也可能为 null。本工具查询版块信息,不用于获取帖子或评论列表。 示例:subreddit_name="pics", language="en-US", need_format=false。
ae_xiaohongshu_fetch_homefeed
获取小红书首页推荐笔记,可按分类频道浏览,并可筛选为仅图文笔记。 输入参数(均为可选): - num:请求的笔记数量,默认 20,最大 40。 - category:分类频道 ID,默认 "homefeed_recommend"。应填写频道 ID,而非搜索关键词。 - cursor_score:翻页游标,首次请求留空,默认为 ""。 - need_filter_image:true 表示仅图文笔记;false 表示综合推荐,可包含视频,默认 false。 返回包含推荐笔记的响应数据。现有响应定义未规定单条笔记的具体字段或分页响应字段。
ae_xiaohongshu_search_groups
按关键词搜索小红书群聊,支持分页查看结果。 输入参数: - keyword(必填):搜索关键词,例如“上海”。 - page_no(可选,默认 0):页码,从 0 开始。 - search_id(可选,默认空字符串):首次搜索留空,由系统自动生成;翻页时传入首次搜索返回的 search_id。 - source(可选,默认 "unifiedSearchGroup"):搜索来源。 - is_recommend(可选,默认 0):是否推荐标记,0 表示否,1 表示是。 返回含义:搜索结果数据,包含群聊列表和分页信息;具体群聊记录的字段结构未作明确约定。 翻页方式:首次请求使用 page_no=0、search_id="";后续请求复用首次搜索返回的 search_id,并递增 page_no。本工具用于发现群聊,不用于加入群聊或读取聊天消息。
ae_pipixia_get_home_short_drama_feed
获取首页短剧推荐数据。 输入:page 为可选整数页码,默认为 1。从 page=1 开始,每次翻页将页码加 1。 返回:响应中的 data 为所请求页的短剧推荐数据。data 可能为空,具体推荐条目的字段未作约定。
ae_pipixia_search
按关键词搜索皮皮虾中的作品、用户和话题。 输入参数: - keyword(必填,字符串):搜索关键词。 - search_type(可选,字符串,默认 "1"):"1" 综合、"8" 热门、"9" 新鲜、"2" 视频、"3" 图文、"4" 用户、"5" 话题。 - offset(可选,字符串,默认 "0"):翻页游标。首次使用 "0";获取后续页时,使用上一页响应返回的 offset 值,不要将其作为页码递增。 返回含义:返回搜索响应,data 中承载搜索结果。具体结果结构未作固定定义,可能因搜索类型而异。 示例:keyword="皮皮虾",search_type="1",offset="0"。
ae_lemon8_search
按关键词搜索 Lemon8 内容、用户账号或话题。 输入参数: - query(必填,字符串):搜索关键词。 - search_tab(可选,字符串,默认 "main"):"main" 表示 Top 综合搜索;"user" 表示 Accounts 用户账号搜索;"hashtag" 表示 Hashtags 话题搜索;"article" 表示 Posts 文章搜索。 - filter_type(可选,字符串,默认 ""):"" 表示全部内容;"video" 表示仅视频;"posts" 表示仅文章。 - order_by(可选,字符串,默认 ""):"" 表示按相关度排序;"popular" 表示按流行度排序;"recent" 表示从新到旧排序。 - max_cursor(可选,字符串,默认 ""):首次请求留空;后续翻页使用上一次响应返回的 max_cursor,并保持搜索条件一致。通过 has_more 判断是否还有更多结果。 返回含义:响应的 data 字段包含当前页搜索结果,并提供用于继续翻页的信息。具体结果条目的字段结构未作明确约定。
ae_threads_search_posts
按关键词搜索 Threads 帖子。 输入: - `query`(必填,字符串):要搜索的关键词,例如 `bitcoin`。 返回: 搜索响应数据,文档描述其中包含匹配帖子的 `results` 列表。每条结果可能包含帖子标识、正文、点赞数、发布时间等帖子信息,用户名、头像、认证状态等作者信息,以及可用的图片、视频或轮播媒体信息。响应结构未对结果详情作固定约束,实际可用字段可能有所不同。 示例:`{"query":"bitcoin"}`
ae_linkedin_get_company_posts
根据 LinkedIn 公司主页 URL 获取该公司发布的帖子。 输入: - `url`(必填):LinkedIn 公司主页 URL,例如 `https://www.linkedin.com/company/microsoft/`。 - `start`(可选):非负整数翻页偏移量。第 1 页传 0,第 2 页传 50,后续每页递增 50。 - `sort_by`(可选):`top` 表示热门帖子,`recent` 表示最新帖子。 - `pagination_token`(可选):不支持,传入无效。请使用 `start` 翻页。 返回公司帖子数据和翻页信息(`count`、`start`、`pagination_token`)。返回的 `pagination_token` 也不能用于获取下一页。 高负载时可能暂时返回 400 或其他错误,建议配置自动重试,重试次数推荐为 3。
ae_xigua_search_video
按关键词搜索西瓜视频,支持排序、时长筛选和分页。 输入: - keyword(必填,字符串):搜索关键词。 - offset(可选,整数,默认 0):首次请求使用 0;后续请求使用上一次响应返回的 offset。 - order_type(可选,字符串):不传或留空时使用默认排序;publish_time 表示按最新排序,play_count 表示按播放量排序。 - min_duration(可选,整数):视频最小时长,单位为秒;不需要时可省略。 - max_duration(可选,整数):视频最大时长,单位为秒;不需要时可省略。 返回:包含视频搜索结果的响应。视频条目的具体字段未作明确约定;如响应返回 offset,可用于继续分页。 示例:keyword="旅行"、order_type="play_count"、min_duration=60、max_duration=180、offset=0,搜索时长为 1–3 分钟的旅行相关视频,并按播放量排序。