ae_instagram_fetch_user_posts
获取 Instagram 用户的帖子。必填参数 user_id 为该用户的 Instagram ID。可选参数 count 用于设置每页数量,范围为 1–50,默认值为 12。首次请求请省略 max_id;请求后续页面时,使用返回的 next_max_id。响应包含 items(帖子列表)、more_available(是否还有后续页面)和 next_max_id(可用时的下一页游标)。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_instagram_fetch_user_posts
获取 Instagram 用户的帖子。必填参数 user_id 为该用户的 Instagram ID。可选参数 count 用于设置每页数量,范围为 1–50,默认值为 12。首次请求请省略 max_id;请求后续页面时,使用返回的 next_max_id。响应包含 items(帖子列表)、more_available(是否还有后续页面)和 next_max_id(可用时的下一页游标)。
ae_douyin_fetch_douplus_user_posts
按页获取指定抖音用户主页的作品列表,支持通过游标继续翻页。 输入: - request_body(必填):包含以下字段的对象。 - sec_uid(必填字符串):目标用户的 sec_uid。 - cursor(可选,字符串或 null):翻页游标,默认 "0"。首页传 "0",后续传上一页响应中的 cursor。 - count(可选,整数或 null):每页数量,默认 10。 - cookie(可选,字符串或 null):用户的 www.douyin.com 网页版 Cookie。 返回:响应中包含用户作品列表和翻页信息。单条作品及翻页数据的详细字段未作定义。
ae_xiaohongshu_pgy_content_square_note_search
在小红书蒲公英内容广场中按关键词搜索笔记,或通过业务分类、时间范围及互动表现排序指标浏览优质笔记。参数请放在必填的 request_body 对象中。
ae_douyin_billboard_fetch_hot_account_search_list
按用户名或抖音号搜索抖音账号。 输入: - keyword(必填,字符串):要搜索的用户名或抖音号。 - cursor(必填,整数):分页游标。文档示例为 0;输入结构未设置自动默认值,调用时需要显式传入。 返回:包含搜索结果的响应,结果位于 data 中,且可能为 null;响应还包含状态信息。现有文档未明确账号结果字段及分页元数据,具体内容以实际返回为准,不应假定固定的结果结构。
ae_wechat_video_search
按关键词搜索微信视频号视频,并可按视频时长、发布时间筛选,按相关性、最新或点赞数排序。 输入(均放在必填的 request_body 对象内): - keyword:必填,去除首尾空白后为 1–100 字。 - duration:可选,all/0(不限,默认)、short/1(少于 5 分钟)、medium/2(5–10 分钟)、long/3(20 分钟及以上)。 - sort:可选,default/0(相关性,默认)、latest/1(发布时间从新到旧)、hot/2(点赞数从高到低)。 - publish_time:可选,all/0(不限,默认)、day/1(最近一天)、week/2(最近七天)、half_year/3(最近半年)。 - 上述三个筛选或排序字段支持所列字符串键或整数代码,不支持的值会被拒绝。 - offset:可选,非负整数,默认 0。首页用 0;仅修改 offset 无法翻页。 - cursor:首页不传。翻页时原样传回上一页响应中的 cursor,并保持 duration、sort、publish_time 与上一页一致。 - raw:可选布尔值,默认 true;true 返回原始搜索响应,false 请求精简解析结果。 返回视频搜索结果,直接获得结果而非后台任务;具体结构随 raw 设置而变化。搜索项提供 exportId、jumpInfo.extInfo.feedNonceId 等视频标识,不直接提供媒体下载地址或 decode_key。若需媒体详情,须使用 exportId 另行查询视频详情。本工具不用于搜索公众号或下载视频。 响应可能较慢;如可配置客户端请求超时,建议设为 30 秒。docID、feedNonceId 等大整数标识须采用无损 JSON 处理并以字符串保存、传递,避免经过 JavaScript Number 导致精度丢失。
ae_xiaohongshu_search_images
根据关键词搜索小红书图片,文档说明每页返回 20 条结果,支持分页。 输入参数: - keyword(必填):搜索关键词,例如“壁纸”。 - page(可选):页码,从 1 开始,默认为 1。 - source(可选):搜索来源,默认为 "explore_feed"。 - search_id、search_session_id、word_request_id(可选):分页标识,均默认为空字符串。首次搜索无需填写;获取后续页面时,保持关键词不变,设置所需页码,并传入首次搜索响应中的这三个标识值。 返回内容:图片搜索结果数据及分页信息;图片数据的具体字段结构未作规定。 首次搜索示例:keyword="壁纸",page=1。
ae_douyin_fetch_one_video_by_share_url
通过分享链接获取单个抖音视频作品的数据。 输入: - share_url(必填,字符串):该作品的分享链接,例如 https://v.douyin.com/e3x2fjE/。 返回含义: - 作品可用时返回作品数据;响应结构未规定作品数据的固定字段集合,具体以实际返回为准。 - 作品已删除、权限受限或因其他原因不可用时,仍可能返回 HTTP 200,并保留 filter_detail。应检查返回内容,不能仅凭 HTTP 成功状态认定作品可访问。 适用于单个作品查询,不用于关键词搜索或批量查询。
ae_douyin_billboard_fetch_hot_total_search_list
## 用途 按关键词、时间窗口和分页设置获取抖音搜索榜。 ## 输入 所有输入均为可选项,放在 `request_body` 对象内: - `keyword`(字符串):搜索关键词,默认 `抖音`。 - `page_num`(整数):页码,默认 `1`。 - `page_size`(整数):每页数量,默认 `10`。 - `date_window`(整数):时间窗口,单位为小时。文档列出的取值为 `1`、`24`、`72`、`168`,分别表示近 1 小时、近 1 天、近 3 天、近 7 天;默认 `24`。 ## 示例 ```json {"request_body":{"keyword":"抖音","page_num":1,"page_size":10,"date_window":24}} ``` ## 返回含义 返回包含状态信息和搜索榜数据的响应,其中 `data` 承载榜单数据。榜单条目结构、具体指标及分页元数据未作明确约定,`data` 可能为空值。本工具用于查询搜索榜,不是通用视频搜索。
ae_xiaohongshu_note_get_rich_detail
根据小红书笔记 ID 获取对应视频笔记的详细信息与元数据。
ae_douyin_billboard_fetch_hot_total_low_fan_list
获取抖音低粉爆款榜,可按时间窗口、关键词和垂类筛选,并分页查看。 输入参数放在 request_body 中: - page:页码,默认 1。 - page_size:每页数量,默认 10。 - date_window:时间窗口,单位为小时,可选 1、24、72、168,分别表示近 1 小时、近 1 天、近 3 天、近 7 天,默认 24。 - keyword:关键词筛选,空字符串表示不按关键词筛选。 - tags:垂类标签筛选,空数组表示全部垂类。每项的 value 为顶级垂类 ID,children 可包含子级标签对象,其 value 为子级垂类 ID;省略 children 表示该顶级垂类下的全部子类。标签 ID 需从内容标签查询中获取。 返回所请求的低粉爆款榜数据及状态信息。榜单内容位于响应的 data 中;具体榜单条目字段及“低粉”的粉丝数门槛未在文档中定义。
ae_tiktok_get_video_comments
通过视频 ID(aweme_id)获取单个视频的评论。视频 ID 为必填项。游标 cursor 为可选项,默认值为 0,用于请求第一页;继续翻页时,请使用上一响应中提供的游标。数量 count 为可选项,默认值为 20,用于指定请求的每页数量。返回评论数据。
ae_bilibili_fetch_video_detail
根据必填的视频 ID(`aid`)获取单个视频的详情。视频详情位于返回结果的 `data` 中,响应还可能包含状态、时间、请求和缓存等元信息。此工具不用于搜索视频。
ae_instagram_fetch_user_following
获取指定 Instagram 用户关注的用户列表。 参数: - `username`:Instagram 用户名。 - `user_id`:Instagram 用户 ID;`username` 和 `user_id` 至少提供一个,二者任选其一。 - `pagination_token`:上一页返回的分页令牌。首次查询可不填,翻页时传入该令牌。 返回:成功响应中的 `data.items` 为关注用户列表;如存在后续页面,`pagination_token` 为下一页分页令牌。
ae_x_twitter_getpostsbyid
根据推文ID读取帖子内容、作者和互动信息。
ae_facebook_search_posts
按关键词搜索 Facebook 公开帖子,支持可选日期筛选和游标分页。keyword 为必填项,支持基础文本匹配;startDate 和 endDate 为可选日期边界,均包含当天,格式为 yyyy-MM-dd。首次搜索可省略 cursor 或使用默认空字符串;获取后续结果时传入可用的分页游标。返回 JSON 响应,包含状态码 code、搜索数据 data、消息 message 和 recordTime。搜索数据中的帖子字段和分页结构未在接口结构中明确规定,不保证包含结果总数或下一页游标。此工具仅检索公开内容,不发布或修改帖子。
ae_bilibili_fetch_general_search
按关键词搜索视频并获取指定页的综合搜索结果。必填参数为 `keyword`、`order`、`page` 和 `page_size`。文档列出的排序值包括:`totalrank`(综合排序)、`click`(最多播放)、`pubdate`(最新发布)、`dm`(最多弹幕)和 `stow`(最多收藏)。可选参数 `duration`:0 表示全部时长,1 表示 10 分钟以下,2 表示 10–30 分钟,3 表示 30–60 分钟,4 表示 60 分钟以上。可选参数 `pubtime_begin_s` 与 `pubtime_end_s` 用 10 位 Unix 时间戳限定发布时间范围,开始时间应早于结束时间。响应包含综合搜索数据,具体字段取决于返回的结果内容。