ae_weibo_topic_search
### 用途 按关键词搜索微博话题,获取匹配话题的名称、封面图、讨论量和阅读量。 ### 输入 - `query`:搜索关键词,必填。 - `page`:页码,选填,默认为 1。 ### 返回 返回话题数据,包括话题名称、封面图、讨论量和阅读量。以“万”或“亿”为单位表示的数量会转换为整数。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_weibo_topic_search
### 用途 按关键词搜索微博话题,获取匹配话题的名称、封面图、讨论量和阅读量。 ### 输入 - `query`:搜索关键词,必填。 - `page`:页码,选填,默认为 1。 ### 返回 返回话题数据,包括话题名称、封面图、讨论量和阅读量。以“万”或“亿”为单位表示的数量会转换为整数。
ae_xiaohongshu_pgy_fan_growth_history
获取指定小红书蒲公英创作者在30天或90天内的粉丝历史数据,可用于追踪创作者的粉丝总量走势或新增粉丝增长情况。参数请放在必填的 request_body 对象中。date_type:1=近30天,2=近60天;不提供90天范围。
ae_bilibili_bv_to_aid
将哔哩哔哩视频的 BV 标识转换为对应的数字 aid(AV 标识)。请在必填字段 `bv_id` 中填写完整的 BV 号。成功时,响应数据中包含转换后的 aid;响应还可能附带一般请求元数据。
ae_bilibili_fetch_video_parts
获取视频的可用分 P 信息。请将视频 BV 号填入 `bv_id`;返回数据包含该视频的分 P 信息。
ae_douyin_fetch_food_aweme
按页获取抖音美食类视频作品数据。 输入: - count(必填,整数):每页请求的作品数量,例如 16;调用时必须显式提供。 - refresh_index(可选,整数):翻页索引,默认值为 1。 - cookie(可选,字符串):用户自行提供的抖音 Cookie。建议使用自己的 Cookie,否则翻页时可能出现数据重复。 返回:JSON 响应,data 字段承载美食作品数据,也可能为 null;响应还包含状态及响应元信息。作品的具体字段结构未作定义,不保证固定的作品字段或翻页结果完全无重复。
ae_instagram_get_user_brief
根据必填的 Instagram 用户名查询账号简要资料。返回内容可能包括账号 ID、用户名、姓名、个人简介、头像链接、认证与隐私状态,以及粉丝数和关注数。部分资料字段可能缺失,也不保证包含近期帖子预览。
ae_kuaishou_web_hot_list
### 用途 获取当前的快手热榜 V1,查看热门内容排行。 ### 输入 无需输入参数。 ### 返回 返回热榜数据及相关响应信息。
ae_youtube_get_shorts_search
## 搜索 YouTube Shorts 按关键词查找 Shorts 短视频,支持语言与地区偏好、上传时间筛选、排序和翻页。 ### 输入条件 - **search_query**(必填):搜索关键词,最多 200 个字符。 - **language_code**:语言偏好,如 en-US、zh-CN;默认 en-US。 - **country_code**:国家或地区代码,如 US、JP;默认 US。 - **time_zone**:用于时间相关筛选的 IANA 时区,如 Asia/Shanghai;默认 America/Los_Angeles。 - **upload_time**:可选 hour、today、week、month、year;省略或传 null 表示不按上传时间筛选。 - **sort_by**:可选 relevance(相关性)、upload_date(上传日期)、view_count(观看次数)、rating(评分);省略或传 null 使用默认相关性排序。同时设置排序与上传时间筛选时,排序优先。 - **filter_mixed_content**:默认 true,过滤首次结果中的长视频;设为 false 则保留原始混合内容,可能包含非 Shorts 视频。 - **continuation_token**:首次请求省略;翻页时使用上一次响应中的令牌,并保持关键词及其他搜索条件一致。令牌可能过期;按接口说明,带令牌的后续请求返回 Shorts 内容。 ### 返回含义 直接返回原始、嵌套的 YouTube 搜索数据,其中包含搜索条目,并在可用时包含下一页令牌。结果不是清洗后的统一视频列表,需要自行解析。翻页令牌用于获取更多搜索结果,不是后台任务标识。
ae_x_get_user_media
## 获取用户媒体 分页获取 X(Twitter)账号的媒体内容。 ### 输入参数 - `screen_name`(必填,字符串):账号用户名,例如 `elonmusk`,可从用户主页链接中获取。 - `rest_id`(可选,整数):用户的数字 ID,例如 `44196397`。提供后优先按该 ID 选择账号,忽略 `screen_name` 的账号选择作用;但输入结构仍要求填写 `screen_name`。 - `cursor`(可选,字符串):首次请求可省略。需要继续翻页时,若上一次响应返回了 `next_cursor`,将其作为本次的 `cursor`。 ### 返回结果 响应数据包含该账号的媒体内容。文档未规定每个媒体条目的固定字段结构。若返回 `next_cursor`,可用它请求后续页面。本工具获取媒体信息,不直接下载媒体文件。 ### 示例 `{"screen_name":"elonmusk"}`
ae_douyin_creator_fetch_creator_hot_spot_billboard
## 用途 获取抖音创作者热点榜单数据,查看热点总榜、同城热点榜或热点上升榜,辅助内容选题。 ## 输入 - `billboard_tag`(字符串,默认 `"0"`):热点标签代码。`"0"` 表示全部标签;多个标签用英文逗号分隔,例如 `"1004,1000,1002"`。 - `hot_search_type`(整数,默认 `1`):`1` = 热点总榜,`2` = 同城热点榜,`3` = 热点上升榜。 - `city_code`(字符串或 null):当 `hot_search_type=2` 时必须提供城市代码;其他榜单可省略或传 null。应填写城市代码,而非城市名称。 ### 分类标签代码 - 站内玩法:`1004,1000,1002,1003,1001` - 话题互动:`20001,20006,20000,20003,20005,20002,20` - 娱乐:`2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006` - 社会:`4005,4006,4007,4003,4004,4000` - 二次元:`13000`;交通:`23000`;亲子:`19000` - 体育:`5002,5000,5001`;军事:`21000`;剧情:`18000` - 动物萌宠:`8000`;天气:`22001,22002`;才艺:`17000` - 文化教育:`14000`;旅行:`10000`;时尚:`16000` - 时政:`3000,3001,3002`;校园:`15000`;汽车:`11000` - 游戏:`12000,12001`;科技:`6000`;美食:`9000`;财经:`7000` ## 返回含义 `data` 承载所选榜单类型及标签条件对应的创作者热点榜单数据,响应同时包含状态元信息。榜单条目的具体字段结构未作定义,不应预设条目字段。本工具返回热点话题榜单,并非创作者账号排名。 ## 示例 `{"billboard_tag":"0","hot_search_type":1}` 表示查询全部标签的热点总榜。
ae_douyin_index_fetch_hot_trend_word
## 用途 获取关键词指数搜索框中的热门推荐词,帮助选择关键词指数分析的输入词。数据按天更新,不是实时热点榜或飙升热点榜,也不提供关键词指数数值。 ## 输入 两个参数均可省略: - `app_name`:`aweme` 表示抖音(默认值),`toutiao` 表示头条;头条当前返回空列表。 - `type`:`0` 表示搜索热词(默认值),其 `id` 固定为字符串 `"0"`;`1` 表示内容热词,带话题 ID。 ## 返回 - `update_time`:数据更新日期,反映按天更新而非实时更新。 - `trend_words`:推荐词列表,每项包含 `id` 和 `word`。 示例:`app_name="aweme", type=0` 获取抖音搜索热词推荐。
ae_kuaishou_app_user_data
通过必填的 user_id 字符串获取单个用户的数据。该值可以是用户的 eid 或 userId。响应会在可用时返回用户数据,并附带状态、消息和请求元数据。
ae_douyin_fetch_multi_video_high_quality_play_url
## 用途 批量获取抖音视频的最高画质(原始上传画质)播放链接,每次最多处理 50 个视频。原始上传画质指创作者上传视频时的画质,不代表对原视频进行超分辨率或画质增强。适用于视频编辑、存档等需要高质量视频链接的场景。 ## 输入 - `request_body`:必填的请求对象。 - `request_body.aweme_ids`:以英文逗号分隔的视频作品 ID 字符串,例如 `"7512756548356492544,7448118827402972455"`,最多 50 个。请传 ID 字符串,而不是数组或分享链接。 - `request_body.region`:可选的请求出口地区,使用 ISO 国家代码,例如 `CN`、`US`、`HK`。地区会影响返回的区域 CDN 链接;中国大陆用户可传 `CN`,以便获得国内 CDN 链接并改善下载速度。 ## 返回 响应数据包含 `total`(总数)、`success_count`(成功数量)、`failed_count`(失败数量)及 `videos`(逐个视频的结果列表)。每个视频条目包含: - `video_id`:视频作品 ID。 - `original_video_url`:最高画质、原始上传画质的播放链接。 - `file_size`:文件大小,单位为字节。 - `file_size_in_mb`:文件大小,单位为 MB。 - `content_type`:内容类型。 - `success`:该视频是否获取成功。 - `error`:获取失败时的错误信息。 批次中可能存在失败条目,请逐项检查 `success` 和 `error`。视频数量较多时处理可能更久,请预留更长等待时间。本工具返回链接和文件信息,不直接下载视频文件。
ae_douyin_index_fetch_content_publish_trend
查询抖音指定内容垂类在某一日期范围内的每日视频发布数量,用于了解内容供给及发布活跃度随时间的变化。 必填输入: - tag_id:具体垂类 ID,以字符串传入,不支持使用 "0" 查询全部垂类。 - start_date:起始日期,格式为 YYYYMMDD,包含当天。 - end_date:结束日期,格式为 YYYYMMDD,包含当天。 返回按日聚合的发布量数据,含日期及当日发布的视频数量。该数量反映发布活动,不代表播放量或互动量。
ae_douyin_search_fetch_discuss_search
## 用途 按关键词搜索抖音讨论区及问答内容,可按排序方式、发布时间、视频时长和内容类型筛选。此工具针对讨论/问答内容,不是抖音全站通用搜索,也不用于获取评论列表。 ## 输入条件 必须提供 `request_body` 对象,其内部字段均为可选: - `keyword`:搜索关键词,默认 `"猫咪"`。 - `cursor`:整数翻页游标,默认 `0`。 - `search_id`、`backtrace`:分页标识,均默认 `""`。 - `sort_type`:`"0"` 综合排序(默认)、`"1"` 最多点赞、`"2"` 最新发布。 - `publish_time`:`"0"` 不限(默认)、`"1"` 最近一天、`"7"` 最近一周、`"180"` 最近半年。 - `filter_duration`:`"0"` 不限(默认)、`"0-1"` 一分钟以内、`"1-5"` 一到五分钟、`"5-10000"` 五分钟以上。 - `content_type`:`"0"` 不限(默认)、`"1"` 视频、`"2"` 图片、`"3"` 文章。 筛选值均使用字符串。首次请求使用 `cursor=0`,`search_id` 和 `backtrace` 为空字符串;继续翻页时,使用上次响应中提供的对应分页值(如有)。 ## 返回含义 响应包含状态码和承载搜索结果的 `data`,其中 `data` 可能为空。文档列出的结果项包括结果类型及 `aweme_info`,后者可包含内容 ID、描述、作者信息、视频播放与封面链接、互动统计、话题标签、音乐、内容状态和分享链接。互动统计可包括点赞数、评论数、分享数、播放数和收藏数,不等于评论正文。返回的视频元数据中,视频时长以毫秒为单位。具体数据结构及字段是否存在以实际响应为准。
ae_douyin_search_fetch_experience_search
## 用途 按关键词搜索抖音经验类内容,包括知识分享、教程、技巧和攻略。 ## 输入 必须提供 `request_body` 对象,对象内的字段均为可选: - `keyword`:搜索关键词,默认值为 `"猫咪"`。 - `cursor`:整数类型的分页游标,默认值为 `0`。 - `search_id`、`backtrace`:字符串类型的分页标识,默认值均为空字符串 `""`。 - `sort_type`:`"0"` 综合排序,`"1"` 最多点赞,`"2"` 最新发布。 - `publish_time`:`"0"` 不限,`"1"` 最近一天,`"7"` 最近一周,`"180"` 最近半年。 - `filter_duration`:`"0"` 不限,`"0-1"` 一分钟以内,`"1-5"` 一到五分钟,`"5-10000"` 五分钟以上。 - `content_type`:`"0"` 不限,`"1"` 视频,`"2"` 图片,`"3"` 文章。 以上四个筛选字段均使用字符串,默认值均为 `"0"`。首次请求使用 `cursor: 0`,`search_id` 和 `backtrace` 使用空字符串;翻页时使用上一次响应返回的分页值。 ## 返回含义 返回对象中的 `data` 为搜索结果载荷。已记录的结果结构包括 `business_data` 数据块,其中可包含 `aweme_list` 视频列表。条目可能提供内容 ID、描述、发布时间戳、作者资料、背景音乐、话题标签、播放地址和封面地址、互动统计、视频状态及分享链接。若返回 `video.duration`,其单位为毫秒。搜索载荷没有固定的结构约束,也可能为 null;具体字段及其是否存在以实际响应为准。