ae_tiktok_fetch_user_live_detail
### 用途 查询指定用户的直播详情。 ### 输入 - `uniqueId`:必填,用户的唯一标识。 ### 返回 返回查询响应及直播详情数据;当没有可用直播详情时,详情数据可能为空。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_tiktok_fetch_user_live_detail
### 用途 查询指定用户的直播详情。 ### 输入 - `uniqueId`:必填,用户的唯一标识。 ### 返回 返回查询响应及直播详情数据;当没有可用直播详情时,详情数据可能为空。
ae_weibo_web_post_detail
获取单条微博的详细信息。 必填参数: - `id`:微博作品 ID。 可选参数: - `is_get_long_text`:是否获取长微博全文,填写字符串 `"true"` 或 `"false"`,默认值为 `"true"`。 返回内容: - 微博的响应数据;在数据可用时,可能包含正文、作者信息、图片或视频等媒体信息,以及点赞、评论、转发等互动数据。
ae_kuaishou_app_videos_batch
使用此工具可在一次请求中获取多个视频或作品的数据。请在 photo_ids 字段中填写 1–40 个以英文逗号分隔的 ID,支持数字 ID 与短字符串 ID 混合使用。响应会在 data 字段中返回获取到的视频数据,并包含状态和响应元数据。
ae_x_get_user_about
获取 X(Twitter)用户的账号档案信息。 输入:screen_name(必填,字符串),即账号的用户名,例如 "elonmusk"。 返回:响应数据中的账号档案信息,可能包含注册时间、账号状态、使用情况等。响应结构未明确规定具体档案字段,实际返回内容可能有所不同。
ae_douyin_billboard_fetch_hot_total_list
## 用途 按指定快照时刻或日期范围获取抖音热点总榜,支持分页以及分类、关键词筛选。 ## 输入条件 - 必填:`page`(整数页码)、`page_size`(整数,每页数量)和 `type`(时间查询模式)。 - `type="snapshot"`:使用 `snapshot_time` 指定快照时刻,格式为 `yyyyMMddHHmmss`。默认值为 `20250106151500`,不表示最新快照;查询其他时刻时应显式传入目标时间。 - `type="range"`:使用 `start_date`、`end_date` 指定开始和结束日期,格式均为 `yyyyMMdd`,默认均为空字符串。`snapshot_time` 仅在 snapshot 模式有效,两个日期参数仅在 range 模式有效。 - 可选 `sentence_tag`:热点分类标签,取自热点榜分类;多个标签用逗号分隔,空值表示全部分类。 - 可选 `keyword`:热点搜索词,默认为空字符串。 ## 返回含义 响应的 `data` 字段承载所选时间、筛选条件和页码对应的热点总榜数据,并附带响应元信息。已提供的响应结构未定义每条榜单记录的具体字段。
ae_douyin_fetch_music_video_list
获取抖音中与指定音乐关联的视频列表,支持按游标翻页。 输入参数: - music_id(必填,字符串):音乐 ID,例如 "7136850194742315016",不是音乐名称或视频 ID。 - cursor(可选,整数,默认 0):第一页使用 0;后续页面使用上一次响应返回的 cursor 值。 - count(可选,整数,默认 10):请保持为 10,修改可能导致错误。 返回含义:响应数据包含该音乐关联的视频列表;单条视频的具体字段未作明确约定。 示例:music_id="7136850194742315016",cursor=0,count=10。
ae_douyin_xingtu_get_ranking_list_data
## 用途 按榜单类型、分类、版本、统计周期和统计日期获取达人榜单数据,覆盖短视频达人商业榜、短视频达人内容榜及直播达人榜。 ## 输入 以下五个参数均可省略,但默认值是固定值: - `code`(整数,默认 `1`):榜单类型代码。短视频商业榜:`1` 品牌优选榜、`2` A3种草榜、`3` 看后搜榜、`4` 带货榜、`5` 投流榜、`6` 高潜榜。短视频内容榜:`17` 涨粉黑马榜、`18` 头部必选榜。直播主播类型(`version="base"`):`23` 游戏主播、`30` 其他主播、`37` 带货主播。直播榜单类型:`23` 游戏行业品牌优选榜、`24` 非游戏行业品牌优选榜、`25` 组件点击榜、`26` 下载转化榜、`27` 线索收集榜、`28` 投流榜、`29` 高潜榜。代码含义依赖榜单场景,尤其 `23` 在不同场景下有不同含义,不应脱离场景使用。 - `qualifier`(字符串,默认 `"1901"`):榜单分类 ID,应从榜单分类目录获取,并与目标榜单分类对应。 - `version`(字符串,默认 `"flow_split"`):`flow_split` 为短视频榜单默认版本,`base` 为直播榜单常用版本。 - `period`(整数,默认 `30`):`7` 表示周榜,`30` 表示月榜。 - `date`(字符串,默认 `"20260131"`):统计日期,格式为 `YYYYMMDD`。请显式指定目标日期;固定默认值不代表当天。 ## 返回含义 返回对象中的 `data` 承载所查询的榜单数据,也可能为 null;返回的 `code` 表示响应状态,与输入的榜单类型代码不是同一含义。现有返回结构未定义榜单条目内的具体字段或指标,不保证包含特定指标。 输入示例:`code=1`、`qualifier="1901"`、`version="flow_split"`、`period=30`、`date="20260131"`。
ae_tiktok_get_user_info
获取指定用户的资料信息。请至少提供一个标识:sec_user_id 或数字 user_id;如果同时提供两者,则优先使用 sec_user_id。返回内容包含用户信息及请求状态相关信息。
ae_weibo_advanced_search
按关键词搜索微博,支持按搜索类别、内容类型、时间范围和页码筛选结果。 输入参数: - q(必填,字符串):搜索关键词。 - search_type(可选,字符串或 null):all(全部)、hot(热门)、original(原创)、verified(认证用户)、media(媒体)或 viewpoint(观点)。 - include_type(可选,字符串或 null):all(全部)、pic(含图片)、video(含视频)、music(含音乐)或 link(含短链)。 - timescope(可选,字符串或 null):自定义时间范围,格式为 custom:开始时间:结束时间,例如 custom:2025-09-01-0:2025-09-08-23。 - page(可选,整数):结果页码,默认为 1。 返回含义:响应的 data 中包含搜索结果,可能包括微博内容、作者信息、图片、视频和互动数据。具体结果结构及可用字段以实际返回为准,已提供的 data 响应定义未限定逐条结果的字段。 注意:播放返回的视频时,播放请求需设置 Referer: https://weibo.com/。该请求头属于视频播放要求,不是搜索参数。
ae_instagram_search_users
### 用途 根据关键词查找 Instagram 用户。 ### 输入 - `keyword`(字符串,必填):用于搜索的关键词。 ### 返回 - `data.items`:匹配的用户结果。响应还可能包含状态和请求元数据。
ae_youtube_search_channels_legacy
## 用途 使用频道 ID 和搜索关键字进行 YouTube 频道搜索。 ## 输入 - `channel_id`(必填,字符串):频道 ID。 - `search_query`(必填,字符串):搜索关键字。 - `language_code`(可选,字符串):语言代码,默认为 `en`。 - `country_code`(可选,字符串):国家代码,默认为 `us`。 - `continuation_token`(可选,字符串):用于继续获取搜索结果的翻页令牌。首次请求时省略;如先前结果提供了令牌,可传入该令牌继续获取结果。 ## 返回 直接返回搜索响应。`data` 字段承载搜索结果数据,也可能为 null;响应还包含状态及消息信息。结果条目结构和翻页令牌所在位置未作具体定义,可用信息以实际返回内容为准。 频道 ID 和搜索关键字均为必填项;不适用于未提供频道 ID 的搜索。
ae_bilibili_fetch_hot_search
获取热门搜索信息。请提供 `limit`,即要返回的条数(整数,默认值为 10,最大值为 50)。响应包含返回的热门搜索数据,具体字段取决于实际返回内容。
ae_douyin_fetch_home_feed
获取抖音网页版首页推荐信息流,支持游客通用推荐和账号个性化推荐。 所有输入均为可选项,放在 request_body 对象内: - count:整数,请求的条目数量,默认 10,建议保持默认值。 - refresh_index:整数,刷新/翻页索引,默认 0。首次获取或刷新时使用 0;加载更多时,每翻一页将索引加 1。 - cookie:抖音网页版登录 Cookie,默认为空。传入后获取该账号的个性化推荐;不传则以游客身份获取通用推荐。 返回包含推荐信息流数据的响应对象,data 承载信息流内容,并附带状态和响应元数据。信息流内容内部的具体字段结构未作约定。
ae_douyin_get_all_aweme_id
从抖音作品链接中批量提取作品 ID(aweme ID),每次最多支持 20 个链接。 输入:必填参数 request_body 为字符串数组。每项可填写抖音短链接、完整作品页或分享页链接,也可填写包含作品链接的复制分享文案。 返回:响应数据包含提取出的作品 ID 列表,可用于后续作品查询。本工具仅提取 ID,不返回作品详情或媒体文件。文档未明确列表的具体结构及单个链接解析失败时的处理方式。 输入示例: {"request_body":["https://v.douyin.com/iRNBho6u/","https://www.douyin.com/video/7298145681699622182"]}
ae_tiktok_get_sec_user_id
# 用途 提取 TikTok 用户主页对应的 sec_user_id。 # 参数 - `url`(必填):用户主页链接,例如 `https://www.tiktok.com/@tiktok`。 # 返回 该账号对应的 sec_user_id,即平台用户 ID。
ae_weibo_hot_search
获取当前微博热搜榜,查看热搜词条及热度信息,支持按分类和城市查询并分页获取。 输入参数(均为可选): - category:榜单分类,默认 realtimehot。已说明的取值包括 mineband(我的热搜)、realtimehot(实时热搜)、social(社会)、fun(文娱)、technologynav(科技)、lifenav(生活)、region(同城)、sportnav(体育)和 gamenav(ACG)。 - page:整数页码,从 1 开始,默认 1。 - count:每页数量,为 1 至 50 的整数,默认 20。 - region_name:城市名称,仅在 category=region 时有效,默认北京。支持的城市包括北京、上海、广州、深圳、杭州、成都、重庆、武汉、南京、天津、西安、长沙、郑州、苏州、东莞、青岛、沈阳、合肥等。 返回所选分类和页码的热搜榜数据,包括热搜词条、热度等;具体数据结构未作规定。榜单持续更新,不同时间请求的结果可能不同。 示例:category="region", region_name="上海", page=1, count=20。