ae_dumplingai_get_youtube_channel
根据 YouTube 频道的 ID、句柄或 URL,获取其详细元数据、统计信息和社交链接。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_dumplingai_get_youtube_channel
根据 YouTube 频道的 ID、句柄或 URL,获取其详细元数据、统计信息和社交链接。
ae_tiktok_fetch_tag_post
# 按标签获取作品 使用此工具列出与指定标签相关的作品。 ### 输入参数 - `challengeID`(必填,字符串):标签 ID。 - `count`(可选,整数,默认值 `30`):每页返回的作品数量。 - `cursor`(可选,整数,默认值 `0`):翻页游标。 ### 返回结果 返回匹配的标签作品数据(如有),以及请求元数据。 ### 视频链接说明 返回数据中的部分视频 CDN 直链可能需要使用返回的 `tt_chain_token` 作为 Cookie: `Cookie: tt_chain_token={tt_chain_token}` 如果该链接仍返回 HTTP 403,请改用返回结果中以 `https://www.tiktok.com/aweme/v1/play/` 开头的视频链接,并且不要携带上述 Cookie。不同视频链接的访问要求可能不同。
ae_douyin_billboard_fetch_hot_total_high_like_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` 指定子级标签;省略 `children` 表示包含该顶级垂类下的全部子级。标签 ID 应从内容标签查询中获取,不应自行编造。 ## 返回含义 响应的 `data` 字段承载高点赞率榜结果,也可能为 null,响应中还包含相关元数据。榜单条目的具体字段及点赞率计算公式未作约定;高点赞率不等同于点赞总数高。 ## 示例 ```json {"request_body":{"page":1,"page_size":10,"date_window":24,"keyword":"","tags":[]}} ```
ae_facebook_list_post_comments
根据必填的帖子唯一标识 postId 获取指定 Facebook 公开帖子的评论。首次请求可省略 cursor 或保留空字符串;继续浏览时传入分页游标。返回 JSON 响应,data 承载结果内容,code、message 和 recordTime 提供响应元信息。评论条目字段及分页元数据的具体结构未明确定义,不应将单次返回视为全部评论。
ae_douyin_fetch_user_profile_by_short_id
通过用户 Short ID 查询抖音用户资料。 输入:short_id 为必填字符串,例如 "114131058",表示要查询的用户 Short ID。 返回:响应中的 data 在有可用数据时包含用户信息,也可能为 null;响应定义未明确列出具体资料字段。输入不符合要求时可能返回参数校验错误。
ae_douyin_search_fetch_multi_search
## 用途 按关键词搜索抖音中的视频、用户、音乐、话题等综合结果,可用于内容发现与搜索聚合。 ## 输入条件 必须提供 `request_body` 对象,其中各字段均可选: - `keyword`(字符串):搜索关键词,默认 `"猫咪"`。 - `cursor`(整数):翻页游标,默认 `0`,用于首次请求。 - `search_id`、`backtrace`(字符串):从上次响应获取的搜索 ID 和翻页回溯标识,默认均为 `""`。 - `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` 外,上述取值应按字符串传入。 首次请求使用 `cursor: 0`、`search_id: ""`,`backtrace` 保持默认空字符串。翻页时,使用上次响应提供的 `cursor`、`search_id` 和 `backtrace`;仅在响应实际提供时复用对应标识。 工具输入示例: ```json {"request_body":{"keyword":"人工智能","cursor":0,"search_id":"","backtrace":"","sort_type":"0","publish_time":"0","filter_duration":"0","content_type":"0"}} ``` ## 返回含义 响应包含状态及请求元信息,搜索内容位于 `data` 中。文档列出的常用搜索字段包括: - `cursor`:下一页游标。 - `has_more`:`1` 表示还有更多结果,`0` 表示没有更多结果。 - `business_data`:搜索结果列表,每项含 `data_id`、`type` 与按类型组织的 `data`。`type=1` 为视频(`aweme_info`),`2` 为用户(`user_info`),`4` 为音乐(`music_info`),`6` 为话题(`cha_info`)。 不同结果可能包含视频描述、作者、播放及封面地址、互动统计、用户资料、音乐标题或话题参与统计。返回项的 `type` 编码与输入筛选项 `content_type` 编码含义不同,不应混用。响应结构未严格限定搜索数据字段,`data` 也可能为空;实际字段、层级和可用性以本次响应为准。
ae_x_get_post_comments
获取指定 X(Twitter)推文下的评论。 输入: - tweet_id(必填,字符串):需要获取评论的推文 ID。 - cursor(可选,字符串):从上一次响应中取得的分页游标。首次请求时省略;如响应提供了后续分页游标,可将其用于下一次请求。 返回:指定推文的评论响应数据。具体评论字段及分页字段名称未作约定,不应假定一次请求会返回全部评论。
ae_xiaohongshu_pgy_creator_data_summary
获取小红书蒲公英创作者的日常笔记或合作笔记数据概览,用于分析和对比创作者的综合表现。参数请放在必填的 request_body 对象中。
ae_tiktok_fetch_post_comment
获取指定视频作品的评论列表。 必填参数: - `aweme_id`:作品 ID。 可选参数: - `cursor`:翻页游标,默认值为 0。 - `count`:每页数量,默认值为 20。 - `current_region`:当前地区,默认为空字符串。 返回结果包含评论数据及相关响应信息。
ae_tiktok_search_hashtags
根据必填关键词搜索相关话题。可选设置 offset(默认 0)跳过部分结果,并设置 count(默认 20)控制请求的结果数量。返回包含匹配话题搜索数据的响应,以及请求状态和可用的元数据。
ae_instagram_fetch_user_reels
### 用途 获取指定 Instagram 用户的 Reels 短视频列表,并支持分页。 ### 输入 - `user_id`(必填):Instagram 用户 ID。 - `count`(可选):每页返回数量,取值为 1–50 的整数,默认值为 12。 - `max_id`(可选):用于请求下一页的分页游标;首次请求时无需传入。 ### 返回 - `items`:获取到的 Reels 列表。 - `paging_info`:用于继续获取结果的分页信息。
ae_douyin_xingtu_get_kolid_by_unique_id
通过抖音号查询对应的游客星图 kolid。 输入:unique_id,必填字符串,表示抖音号,可从账号资料中获取。示例:m6640150。 返回:JSON 响应,data 承载查询结果,并附带响应状态信息;文档未明确 data 的内部结构。kolid 是本次查询的星图标识,不是输入的抖音号;本工具不用于获取完整账号资料或分析指标。
ae_tiktok_video_tag_search
按指定标签查询使用该标签的 TikTok 视频相关标签统计,可用于研究热门视频、新标签、标签相关播放量及推广商品数量。必填 tag_name 为要查询的标签名,例如 fashion。可选 site 支持 Unknow、US、MY、PH、VN、TH、ID、GB、JP,默认值为 Unknow;可选 page 为页码,从 1 开始,默认为 1,每页最多 20 个标签。提供方未定义输出 Schema,因此不保证固定的返回字段或各项指标均可获得。
ae_douyin_billboard_fetch_hot_total_topic_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` 承载话题榜查询结果,并附带响应状态和提示信息。已提供的响应定义未约定单条话题的具体字段。 ## 示例 ```json {"request_body":{"page":1,"page_size":10,"date_window":24,"keyword":"","tags":[]}} ```
ae_kuaishou_app_video_search
### 用途 按关键词搜索视频内容,并支持使用分页游标获取后续结果。 ### 输入 - `keyword`:必填,搜索关键词。 - `pcursor`:可选,分页游标。首次搜索时留空或省略;翻页时填写上一页响应中的 `pcursor`。 ### 返回 返回视频搜索数据;响应还可能包含请求状态、时间和请求标识等元信息。
ae_douyin_billboard_fetch_hot_account_item_analysis_list
获取指定抖音账号的作品分析。 输入:sec_uid(必填,字符串),即该账号的用户 sec_id。本工具不支持指定自定义分析时间范围。 返回:包含账号作品分析数据及响应状态信息的结果。分析内容位于 data 中,可能为空;具体分析字段未在响应结构中定义,应以实际返回内容为准。