> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 可用的 MCP 端点

> 跨 450+ 个数据源的全部 1,100+ 个 Anysite MCP 服务器端点的完整参考

## 端点参考

通过 Anysite MCP 服务器可用的全部 **2,400+ 个端点** 的完整参考。有关架构概述和入门指南，请参阅 [MCP 服务器概述](/mcp-server/overview)。

<Note>
  以下所有端点都通过 `execute(source, category, endpoint, params)` 调用。此处列出的端点名称用作 `endpoint` 参数。
  使用 `discover(source, category)` 可查找任何端点的确切参数模式。

  每次 `execute()` 调用都会返回一个 `cache_key` — 将其与 [query\_cache 和 export\_data](/mcp-server/data-analysis) 一起使用，可进行服务器端过滤、聚合和导出。
</Note>

## 快速导航

* [Web Search](#web-search) (1 endpoint)
* [Y Combinator](#y-combinator) (3 endpoints)
* [YouTube](#youtube) (14 endpoints)
* [SEC](#sec) (2 endpoints)
* [LinkedIn](#linkedin) (35 endpoints)
* [Instagram](#instagram) (8 endpoints)
* [Twitter/X](#twitterx) (4 endpoints)
* [Reddit](#reddit) (11 endpoints)
* [Web Parser](#web-parser) (2 endpoints)
* [Other Sources](#other-sources) (\~100 endpoints)

***

## Web Search

**数据源:** `duckduckgo` | **类别:** `search`

### `duckduckgo_search`

返回结构化结果的网络搜索解析器（DuckDuckGo）。

**描述**: 按查询进行的网络搜索解析器。返回最多 20 条按相关性排序的结果。由 DuckDuckGo 提供支持。

**参数:**

| 参数                | 类型      | 必填   | 默认值 | 描述                        | 约束                 |
| ----------------- | ------- | ---- | --- | ------------------------- | ------------------ |
| `query`           | string  | ✅ 是  | -   | 搜索查询（例如 'python fastapi'） | -                  |
| `count`           | integer | ❌ 可选 | 10  | 最大结果数                     | Min: 1, Max: 20    |
| `request_timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）                   | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "fastapi tutorial",
  "count": 15,
  "request_timeout": 300
}
```

**使用场景:**

* 网络研究和信息收集
* 查找文档和教程
* 竞争情报
* 内容发现

***

## Y Combinator

**数据源:** `yc` | **类别:** `company`, `search`

<Note>
  Y Combinator 端点提供对创业公司情报、公司数据以及来自全球最负盛名的创业加速器的创始人信息的访问。
</Note>

### `get_yc_company`

通过 slug 获取某个 Y Combinator 公司的全面信息。

**描述**: 获取 Y Combinator 公司信息，包括描述、批次、创始人和指标。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                                                  | 约束                 |
| --------- | ------- | ---- | --- | --------------------------------------------------- | ------------------ |
| `slug`    | string  | ✅ 是  | -   | Y Combinator 公司 slug（例如 "airbnb"、"stripe"、"reddit"） | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）                                             | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "slug": "airbnb",
  "timeout": 300
}
```

**响应包含:**

* 公司名称和描述
* YC 批次（例如 "W09"、"S16"）
* 公司状态（Active、Acquired、Public、Inactive）
* 网站和社交链接
* 成立年份和团队规模
* 地点和标签/行业
* 创始人信息

**使用场景:**

* 创业公司研究和竞争情报
* 投资管道分析
* 批次队列研究
* 创始人背景研究

***

### `search_yc_companies`

使用高级过滤选项搜索 Y Combinator 公司。

**描述**: 按关键词、批次、行业标签和状态过滤器搜索 YC 公司。

**参数:**

| 参数        | 类型             | 必填   | 默认值 | 描述                                            | 约束                 |
| --------- | -------------- | ---- | --- | --------------------------------------------- | ------------------ |
| `query`   | string         | ❌ 可选 | ""  | 搜索关键词（公司名称、描述、标签）                             | -                  |
| `batch`   | string         | ❌ 可选 | -   | 按批次过滤（例如 "W23"、"S22"）                         | -                  |
| `status`  | string         | ❌ 可选 | -   | 按状态过滤："Active"、"Acquired"、"Public"、"Inactive" | -                  |
| `tags`    | array\[string] | ❌ 可选 | -   | 按行业标签/类别过滤                                    | -                  |
| `count`   | integer        | ❌ 可选 | 10  | 最大结果数                                         | Min: 1, Max: 100   |
| `offset`  | integer        | ❌ 可选 | 0   | 分页偏移量                                         | Min: 0             |
| `timeout` | integer        | ❌ 可选 | 300 | 请求超时（秒）                                       | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "AI",
  "batch": "W23",
  "count": 20,
  "timeout": 300
}
```

**使用场景:**

* 查找特定批次中的公司
* 按行业/垂直领域研究公司
* 跟踪收购和成功退出
* 发现新兴创业公司
* 构建投资交易流

***

### `search_yc_founders`

使用批次、公司、行业和职位过滤器搜索 Y Combinator 创始人。

**描述**: 按姓名、公司、批次、行业和职位搜索 YC 创始人。

**参数:**

| 参数              | 类型             | 必填   | 默认值   | 描述                    | 约束                 |
| --------------- | -------------- | ---- | ----- | --------------------- | ------------------ |
| `query`         | string         | ❌ 可选 | ""    | 按创始人姓名搜索              | -                  |
| `company`       | string         | ❌ 可选 | -     | 按公司 slug 过滤           | -                  |
| `batch`         | string         | ❌ 可选 | -     | 按批次过滤（例如 "W23"、"S22"） | -                  |
| `industries`    | array\[string] | ❌ 可选 | -     | 按 YC 行业过滤             | -                  |
| `titles`        | array\[string] | ❌ 可选 | -     | 按创始人职位过滤（CEO、CTO 等）   | -                  |
| `top_company`   | boolean        | ❌ 可选 | false | 仅过滤顶级 YC 公司的创始人       | -                  |
| `page`          | integer        | ❌ 可选 | 0     | 分页页码                  | Min: 0             |
| `hits_per_page` | integer        | ❌ 可选 | 100   | 每页结果数                 | Min: 1, Max: 100   |
| `timeout`       | integer        | ❌ 可选 | 300   | 请求超时（秒）               | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "Sam Altman",
  "industries": ["AI", "Enterprise"],
  "top_company": true,
  "hits_per_page": 20,
  "timeout": 300
}
```

**响应包含:**

* 创始人姓名（名和姓）
* 当前公司和职位
* 用于进一步查询的公司 slug
* YC 批次和行业
* 头像/个人资料图片
* 所有公司文本
* 顶级公司标识

**使用场景:**

* 创始人背景研究
* 人才寻源和招聘
* 网络图谱和人脉关系
* 领导团队分析
* 连续创业者识别

***

## YouTube

**数据源:** `youtube` | **类别:** `search`, `video`, `channel`

<Note>
  YouTube 端点提供对视频搜索、频道视频、详细视频信息、评论和字幕提取功能的访问。
</Note>

### `search_youtube_videos`

通过查询搜索 YouTube 视频，并控制结果数量限制。

**描述**: 按查询搜索 YouTube 视频，并返回结构化的视频数据，包括标题、描述、观看次数和互动指标。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                                                   | 约束                 |
| --------- | ------- | ---- | --- | ---------------------------------------------------- | ------------------ |
| `query`   | string  | ✅ 是  | -   | 搜索查询（例如 "python tutorial"、"machine learning basics"） | -                  |
| `count`   | integer | ✅ 是  | -   | 要返回的最大结果数                                            | Min: 1, Max: 600   |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）                                              | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "fastapi tutorial",
  "count": 20,
  "timeout": 300
}
```

**响应包含:**

* 视频 ID 和 URL
* 标题和描述
* 观看次数、点赞数和评论数
* 上传日期和时长
* 频道信息
* 缩略图 URL

**使用场景:**

* 内容研究和发现
* 竞争对手分析
* 教育资源查找
* 视频趋势分析
* 内容策略规划

***

### `get_youtube_video`

通过 ID 或 URL 获取特定 YouTube 视频的全面详情。

**描述**: 检索 YouTube 视频的详细信息，包括元数据、互动指标、频道数据和视频统计。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                    | 约束                 |
| --------- | ------- | ---- | --- | --------------------- | ------------------ |
| `video`   | string  | ✅ 是  | -   | YouTube 视频 ID 或完整 URL | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）               | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "video": "dQw4w9WgXcQ",
  "timeout": 300
}
```

或使用完整 URL:

```json theme={null}
{
  "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "timeout": 300
}
```

**响应包含:**

* 完整的视频元数据
* 观看次数、点赞数、踩数
* 评论数和统计
* 上传日期和时长
* 频道信息（名称、订阅者数）
* 视频描述和标签
* 类别和语言
* 缩略图图像

**使用场景:**

* 视频分析和监测
* 内容表现跟踪
* 竞争对手视频分析
* SEO 研究
* 互动指标收集

***

### `get_youtube_video_subtitles`

以指定语言从 YouTube 视频中提取字幕/隐藏式字幕。

**描述**: 检索带时间戳的视频字幕（隐藏式字幕），用于无障碍访问、内容分析或转录目的。

**参数:**

| 参数        | 类型      | 必填   | 默认值  | 描述                                   | 约束                 |
| --------- | ------- | ---- | ---- | ------------------------------------ | ------------------ |
| `video`   | string  | ✅ 是  | -    | YouTube 视频 ID 或完整 URL                | -                  |
| `lang`    | string  | ❌ 可选 | "en" | 语言代码（ISO 639-1 格式: 'en'、'ru'、'es' 等） | -                  |
| `timeout` | integer | ❌ 可选 | 300  | 请求超时（秒）                              | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "video": "dQw4w9WgXcQ",
  "lang": "en",
  "timeout": 300
}
```

**响应包含:**

* 完整字幕文本
* 带时间戳的单条字幕行
* 语言信息
* 字幕数量和时长
* 时间同步数据

**使用场景:**

* 内容转录
* 无障碍合规
* 视频内容分析
* 翻译工作流程
* SEO 内容提取
* 教育材料准备

***

### `get_youtube_channel_videos`

通过 URL、别名或 ID 获取 YouTube 频道的所有视频。

**描述**: 检索 YouTube 频道的所有视频列表，包括元数据、互动指标和上传信息。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                                 | 约束                 |
| --------- | ------- | ---- | --- | ---------------------------------- | ------------------ |
| `channel` | string  | ✅ 是  | -   | YouTube 频道 URL、别名（@username）或频道 ID | -                  |
| `count`   | integer | ❌ 可选 | 50  | 要返回的最大视频数                          | Min: 1, Max: 600   |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）                            | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "channel": "https://www.youtube.com/@mkbhd",
  "count": 30,
  "timeout": 300
}
```

或使用频道别名:

```json theme={null}
{
  "channel": "@mkbhd",
  "count": 50
}
```

**响应包含:**

* 每个视频的视频 ID 和 URL
* 标题和描述
* 观看次数、点赞数和评论数
* 上传日期和时长
* 缩略图 URL
* 频道信息

**使用场景:**

* 频道内容审计
* 竞争对手频道分析
* 内容日历研究
* 视频表现基准测试
* 网红视频清单

***

### `get_youtube_video_comments`

通过 ID 或 URL 获取 YouTube 视频的评论。

**描述**: 检索 YouTube 视频的评论，包括作者信息、点赞数和回复数据。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                    | 约束                 |
| --------- | ------- | ---- | --- | --------------------- | ------------------ |
| `video`   | string  | ✅ 是  | -   | YouTube 视频 ID 或完整 URL | -                  |
| `count`   | integer | ❌ 可选 | 50  | 要返回的最大评论数             | Min: 1, Max: 600   |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）               | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "video": "dQw4w9WgXcQ",
  "count": 100,
  "timeout": 300
}
```

或使用完整 URL:

```json theme={null}
{
  "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "count": 50
}
```

**响应包含:**

* 评论文本和作者
* 作者频道信息
* 点赞数和回复数
* 评论时间戳
* 是否为回复标识
* 作者个人资料图片

**使用场景:**

* 情感分析
* 社区反馈研究
* 产品提及跟踪
* 竞争对手评论监测
* 网红互动分析

***

## SEC

**数据源:** `sec` | **类别:** `search`, `document`

<Note>
  SEC 端点提供对美国证券交易委员会 EDGAR 数据库的访问，用于获取公司文件、财务文档和监管披露。
</Note>

### `search_sec_companies`

使用高级过滤选项在 SEC EDGAR 数据库中搜索公司文件。

**描述**: 按公司名称、股票代码、表格类型、日期范围和地点过滤器搜索 SEC 文件。

**参数:**

| 参数               | 类型             | 必填   | 默认值  | 描述                                                                  | 约束                 |
| ---------------- | -------------- | ---- | ---- | ------------------------------------------------------------------- | ------------------ |
| `entity_name`    | string         | ❌ 可选 | ""   | 公司名称或股票代码（例如 "Apple"、"AAPL"）                                        | -                  |
| `forms`          | array\[string] | ❌ 可选 | null | 要包含的表格类型（例如 \["10-K", "10-Q", "8-K"]）或使用 '-' 前缀排除（例如 \["-3", "-4"]） | -                  |
| `location_codes` | array\[string] | ❌ 可选 | null | 要过滤的州代码（例如 \["CA", "NY"]）                                           | -                  |
| `date_from`      | string         | ❌ 可选 | null | 起始日期，YYYY-MM-DD 格式                                                  | -                  |
| `date_to`        | string         | ❌ 可选 | null | 结束日期，YYYY-MM-DD 格式                                                  | -                  |
| `timeout`        | integer        | ❌ 可选 | 300  | 请求超时（秒）                                                             | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "entity_name": "Apple",
  "forms": ["10-K", "10-Q"],
  "date_from": "2024-01-01",
  "date_to": "2024-12-31",
  "timeout": 300
}
```

**响应包含:**

* 受理号（唯一文件 ID）
* 文件名和文档类型
* 文件提交日期
* 公司 CIK（中央索引键）
* 表格类型
* 用于检索的文档 URL

**使用场景:**

* 财务研究和分析
* 尽职调查
* 监管合规监测
* 投资研究
* 公司情报收集
* 历史文件分析

***

### `get_sec_document`

通过 URL 检索特定 SEC EDGAR 文档的完整内容。

**描述**: 获取并解析 SEC EDGAR 文档，包括 10-K、10-Q、8-K、委托书声明和其他监管文件。

**参数:**

| 参数             | 类型      | 必填   | 默认值 | 描述                            | 约束                 |
| -------------- | ------- | ---- | --- | ----------------------------- | ------------------ |
| `document_url` | string  | ✅ 是  | -   | SEC EDGAR 文档的直接 URL（从搜索结果中获得） | -                  |
| `timeout`      | integer | ❌ 可选 | 300 | 请求超时（秒）                       | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/ef20060722_8k.htm",
  "timeout": 300
}
```

**响应包含:**

* 文档 URL
* 完整文档内容（HTML 或 XML）
* 内容类型
* 已解析和清理的文档文本

**使用场景:**

* 财务报表分析
* 风险因素评估
* 管理层讨论审查（MD\&A）
* 高管薪酬分析
* 并购研究
* 法律和监管合规

**常见表格类型:**

* **10-K**: 包含全面公司概述的年度报告
* **10-Q**: 季度财务报告
* **8-K**: 重大事件的当期报告
* **DEF 14A**: 委托书声明（股东大会）
* **S-1**: 新证券的注册声明
* **4**: 实益所有权变更声明

***

## LinkedIn

**数据源:** `linkedin` | **类别:** `search`, `user`, `company`, `post`, `email`, `job_search`, `group`, `google`

<Note>
  LinkedIn 是最全面的类别，拥有 **35 个端点**，涵盖个人资料、公司、帖子、搜索、技能、经历和互动数据。
</Note>

### 搜索与发现

**类别:** `search`

#### `search_linkedin_users`

根据各种条件搜索 LinkedIn 用户。

**描述**: 根据各种条件搜索 LinkedIn 用户

**参数:**

| 参数                 | 类型      | 必填   | 默认值 | 描述      |
| ------------------ | ------- | ---- | --- | ------- |
| `keywords`         | string  | ❌ 可选 | -   | 通用搜索关键词 |
| `first_name`       | string  | ❌ 可选 | -   | 按名过滤    |
| `last_name`        | string  | ❌ 可选 | -   | 按姓过滤    |
| `title`            | string  | ❌ 可选 | -   | 按职位过滤   |
| `company_keywords` | string  | ❌ 可选 | -   | 按公司名称过滤 |
| `school_keywords`  | string  | ❌ 可选 | -   | 按学校名称过滤 |
| `location`         | string  | ❌ 可选 | -   | 按地点名称过滤 |
| `count`            | integer | ❌ 可选 | 10  | 结果数量    |
| `request_timeout`  | integer | ❌ 可选 | 300 | 请求超时（秒） |

**示例:**

```json theme={null}
{
  "keywords": "software engineer",
  "location": "San Francisco",
  "count": 20
}
```

***

#### `search_linkedin_companies`

使用高级过滤选项搜索 LinkedIn 公司。

**描述**: 搜索 LinkedIn 公司

**参数:**

| 参数               | 类型             | 必填   | 默认值 | 描述                                    | 约束                 |
| ---------------- | -------------- | ---- | --- | ------------------------------------- | ------------------ |
| `count`          | integer        | ✅ 是  | -   | 最大结果数                                 | Max: 1000          |
| `keywords`       | string         | ❌ 可选 | ""  | 用于在公司页面中搜索的任意关键词。如需精确搜索，请将所需关键词放入方括号中 | -                  |
| `location`       | string         | ❌ 可选 | \[] | 地点 URN 或地点名称                          | -                  |
| `industry`       | string         | ❌ 可选 | \[] | 行业 URN 或行业名称                          | -                  |
| `employee_count` | array\[string] | ❌ 可选 | \[] | 员工人数过滤器                               | -                  |
| `timeout`        | integer        | ❌ 可选 | 300 | 最大抓取执行超时（秒）                           | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "keywords": "software company",
  "location": "United States",
  "count": 100
}
```

***

#### `search_linkedin_educations`

在 LinkedIn 上搜索教育机构。

**描述**: 搜索 LinkedIn 教育机构

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `name`    | string  | ✅ 是  | -   | 教育机构名称      | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "name": "Stanford University",
  "count": 10
}
```

***

#### `search_linkedin_industries`

在 LinkedIn 上搜索行业。

**描述**: 搜索 LinkedIn 行业

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `name`    | string  | ✅ 是  | -   | 行业名称        | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "name": "Software",
  "count": 10
}
```

***

#### `search_linkedin_locations`

在 LinkedIn 上搜索地点以用于过滤器。

**描述**: 搜索 LinkedIn 地点

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `name`    | string  | ✅ 是  | -   | 地点名称        | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "name": "San Francisco",
  "count": 10
}
```

***

### 用户个人资料

**类别:** `user`

#### `get_linkedin_profile`

获取 LinkedIn 个人资料的详细信息，包括经历、教育和技能。

**描述**: 获取 LinkedIn 个人资料的详细信息

**参数:**

| 参数                | 类型      | 必填   | 默认值  | 描述                     | 约束                 |
| ----------------- | ------- | ---- | ---- | ---------------------- | ------------------ |
| `user`            | string  | ✅ 是  | -    | LinkedIn 个人资料 URL 或用户名 | -                  |
| `request_timeout` | integer | ❌ 可选 | 300  | 请求超时（秒）                | Min: 20, Max: 1500 |
| `with_experience` | boolean | ❌ 可选 | true | 包含经历数据                 | -                  |
| `with_education`  | boolean | ❌ 可选 | true | 包含教育数据                 | -                  |
| `with_skills`     | boolean | ❌ 可选 | true | 包含技能数据                 | -                  |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/john-doe",
  "with_experience": true,
  "with_education": true,
  "with_skills": true
}
```

***

#### `find_linkedin_user_email`

通过电子邮件地址查找 LinkedIn 用户。

**描述**: 查找 LinkedIn 用户电子邮件

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                | 约束                 |
| --------- | ------- | ---- | --- | ----------------- | ------------------ |
| `email`   | string  | ✅ 是  | -   | 用于通过电子邮件获取用户的电子邮件 | -                  |
| `count`   | integer | ❌ 可选 | 5   | 最大结果数             | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）       | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "email": "john.doe@example.com"
}
```

***

#### `get_linkedin_user_email_db`

从内部数据库获取 LinkedIn 用户电子邮件。

**描述**: 从数据库获取 LinkedIn 用户电子邮件

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                                              | 约束                 |
| --------- | ------- | ---- | --- | ----------------------------------------------- | ------------------ |
| `profile` | string  | ✅ 是  | -   | LinkedIn internal\_id、个人资料 URL、别名，或其集合（最多 10 个） | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）                                     | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "profile": "https://www.linkedin.com/in/john-doe"
}
```

***

#### `get_linkedin_user_posts`

获取 LinkedIn 用户个人资料的帖子。

**描述**: 获取 LinkedIn 用户帖子

**参数:**

| 参数             | 类型      | 必填   | 默认值 | 描述                             | 约束                 |
| -------------- | ------- | ---- | --- | ------------------------------ | ------------------ |
| `urn`          | string  | ✅ 是  | -   | 用户 URN（fsd\_profile 类型）或用户 URL | -                  |
| `count`        | integer | ✅ 是  | -   | 最大结果数                          | -                  |
| `posted_after` | string  | ❌ 可选 | -   | 过滤指定日期（时间戳）之后创建的帖子             | -                  |
| `timeout`      | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）                    | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 20
}
```

***

#### `get_linkedin_user_comments`

获取 LinkedIn 用户的评论。

**描述**: 获取 LinkedIn 用户评论

**参数:**

| 参数                | 类型      | 必填   | 默认值 | 描述                        | 约束                 |
| ----------------- | ------- | ---- | --- | ------------------------- | ------------------ |
| `urn`             | string  | ✅ 是  | -   | 用户 URN（仅 fsd\_profile 类型） | -                  |
| `count`           | integer | ✅ 是  | -   | 最大结果数                     | -                  |
| `commented_after` | string  | ❌ 可选 | -   | 过滤指定日期（时间戳）之后创建的评论        | -                  |
| `timeout`         | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）               | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 50
}
```

***

#### `get_linkedin_user_reactions`

获取 LinkedIn 用户的互动。

**描述**: 获取 LinkedIn 用户互动

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                        | 约束                 |
| --------- | ------- | ---- | --- | ------------------------- | ------------------ |
| `urn`     | string  | ✅ 是  | -   | 用户 URN（仅 fsd\_profile 类型） | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数                     | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）               | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 100
}
```

***

### 公司信息

**类别:** `company`

#### `get_linkedin_company`

获取全面的 LinkedIn 公司信息。

**描述**: 获取 LinkedIn 公司信息

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述             | 约束                 |
| --------- | ------- | ---- | --- | -------------- | ------------------ |
| `company` | string  | ✅ 是  | -   | 公司别名、URL 或 URN | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）    | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "company": "https://www.linkedin.com/company/microsoft"
}
```

***

#### `get_linkedin_company_employee_stats`

获取 LinkedIn 公司的员工统计。

**描述**: 获取 LinkedIn 公司员工统计

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `urn`     | string  | ✅ 是  | -   | 公司 URN      | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:company:1234"
}
```

***

#### `get_linkedin_company_posts`

获取 LinkedIn 公司页面的帖子。

**描述**: 获取 LinkedIn 公司帖子

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                   | 约束                 |
| --------- | ------- | ---- | --- | -------------------- | ------------------ |
| `urn`     | string  | ✅ 是  | -   | 公司 URN（仅 company 类型） | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数                | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）          | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:company:1234",
  "count": 20
}
```

***

### 内容与帖子

**类别:** `post`

#### `search_linkedin_posts`

使用高级过滤器搜索 LinkedIn 帖子。

**描述**: 搜索 LinkedIn 帖子

**参数:**

| 参数                  | 类型      | 必填   | 默认值          | 描述                                  | 约束                 |
| ------------------- | ------- | ---- | ------------ | ----------------------------------- | ------------------ |
| `count`             | integer | ✅ 是  | -            | 最大结果数                               | Max: 1000          |
| `keywords`          | string  | ❌ 可选 | ""           | 用于在帖子中搜索的任意关键词。如需精确搜索，请将所需关键词放入方括号中 | -                  |
| `sort`              | string  | ❌ 可选 | "relevance"  | 排序类型                                | -                  |
| `date_posted`       | string  | ❌ 可选 | "past-month" | 发布日期过滤器                             | -                  |
| `content_type`      | string  | ❌ 可选 | -            | 所需的内容类型                             | -                  |
| `mentioned`         | string  | ❌ 可选 | -            | 帖子中提及的用户 URN                        | -                  |
| `authors`           | string  | ❌ 可选 | -            | 帖子作者的 URN                           | -                  |
| `author_industries` | string  | ❌ 可选 | -            | 行业 URN 或行业名称                        | -                  |
| `author_title`      | string  | ❌ 可选 | -            | 作者职位                                | -                  |
| `timeout`           | integer | ❌ 可选 | 300          | 最大抓取执行超时（秒）                         | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "keywords": "artificial intelligence",
  "date_posted": "past-week",
  "count": 50
}
```

***

#### `get_linkedin_post`

获取特定 LinkedIn 帖子的详细信息。

**描述**: 获取 LinkedIn 帖子

**参数:**

| 参数                            | 类型      | 必填   | 默认值   | 描述             | 约束                 |
| ----------------------------- | ------- | ---- | ----- | -------------- | ------------------ |
| `urn`                         | string  | ✅ 是  | -     | 帖子 URN 或 slug  | -                  |
| `include_all_document_images` | boolean | ❌ 可选 | false | 如果启用，将包含所有文档图像 | -                  |
| `timeout`                     | integer | ❌ 可选 | 300   | 最大抓取执行超时（秒）    | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:activity:1234567890"
}
```

***

#### `get_linkedin_post_comments`

获取 LinkedIn 帖子的评论。

**描述**: 获取 LinkedIn 帖子评论

**参数:**

| 参数        | 类型      | 必填   | 默认值      | 描述                    | 约束                 |
| --------- | ------- | ---- | -------- | --------------------- | ------------------ |
| `urn`     | string  | ✅ 是  | -        | 帖子 URN（仅 activity 类型） | -                  |
| `count`   | integer | ✅ 是  | -        | 最大结果数                 | -                  |
| `sort`    | string  | ❌ 可选 | "recent" | 排序类型。相关性可能不会返回所有结果    | -                  |
| `timeout` | integer | ❌ 可选 | 300      | 最大抓取执行超时（秒）           | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:activity:1234567890",
  "count": 50
}
```

***

#### `get_linkedin_post_reactions`

获取 LinkedIn 帖子的互动。

**描述**: 获取 LinkedIn 帖子互动

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                    | 约束                 |
| --------- | ------- | ---- | --- | --------------------- | ------------------ |
| `urn`     | string  | ✅ 是  | -   | 帖子 URN（仅 activity 类型） | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数                 | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）           | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:activity:1234567890",
  "count": 100
}
```

***

#### `get_linkedin_post_reposts`

获取 LinkedIn 帖子的转发。

**描述**: 获取 LinkedIn 帖子转发

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                    | 约束                 |
| --------- | ------- | ---- | --- | --------------------- | ------------------ |
| `urn`     | string  | ✅ 是  | -   | 帖子 URN（仅 activity 类型） | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数                 | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）           | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "urn": "urn:li:activity:1234567890",
  "count": 50
}
```

***

### 工作与群组

**类别:** `job_search`, `group`

#### `search_linkedin_jobs`

在 LinkedIn 上搜索职位发布。

**描述**: 搜索 LinkedIn 职位

**参数:**

| 参数                 | 类型      | 必填   | 默认值         | 描述                                  | 约束                 |
| ------------------ | ------- | ---- | ----------- | ----------------------------------- | ------------------ |
| `count`            | integer | ✅ 是  | -           | 最大结果数                               | Max: 1000          |
| `keywords`         | string  | ❌ 可选 | ""          | 用于在职位中搜索的任意关键词。如需精确搜索，请将所需关键词放入方括号中 | -                  |
| `sort`             | string  | ❌ 可选 | -           | 职位排序类型                              | -                  |
| `experience_level` | string  | ❌ 可选 | -           | 职位经验级别                              | -                  |
| `job_types`        | string  | ❌ 可选 | -           | 职位类型                                | -                  |
| `work_types`       | string  | ❌ 可选 | -           | 工作类型                                | -                  |
| `industry`         | string  | ❌ 可选 | -           | 行业 URN                              | -                  |
| `company`          | string  | ❌ 可选 | -           | 公司 URN                              | -                  |
| `location`         | string  | ❌ 可选 | "worldwide" | 职位地点                                | -                  |
| `timeout`          | integer | ❌ 可选 | 300         | 最大抓取执行超时（秒）                         | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "keywords": "python developer",
  "location": "San Francisco",
  "count": 50
}
```

***

#### `get_linkedin_group`

获取 LinkedIn 群组的信息。

**描述**: 获取 LinkedIn 群组信息

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述           | 约束                 |
| --------- | ------- | ---- | --- | ------------ | ------------------ |
| `group`   | string  | ✅ 是  | -   | 群组 URN 或 URL | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）  | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "group": "https://www.linkedin.com/groups/123456"
}
```

***

### Google 搜索

**类别:** `google`

#### `search_linkedin_google_company`

通过 Google 搜索 LinkedIn 公司页面。

**描述**: 使用 Google 搜索集成查找 LinkedIn 公司页面以进行更广泛的发现

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述      | 约束                 |
| --------- | ------- | ---- | --- | ------- | ------------------ |
| `query`   | string  | ✅ 是  | -   | 公司搜索查询  | -                  |
| `count`   | integer | ❌ 可选 | 10  | 最大结果数   | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "OpenAI",
  "count": 5
}
```

***

### 个人资料详情

**类别:** `user`

#### `get_linkedin_user_experience`

获取 LinkedIn 个人资料的工作经历历史。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_education`

获取 LinkedIn 个人资料的教育历史。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_skills`

获取 LinkedIn 个人资料上列出的技能。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_endorsers`

获取 LinkedIn 个人资料技能的认可者。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_certificates`

获取 LinkedIn 个人资料的认证。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_honors`

获取 LinkedIn 个人资料的荣誉和奖项。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_languages`

获取 LinkedIn 个人资料上列出的语言。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

#### `get_linkedin_user_patents`

获取 LinkedIn 个人资料上列出的专利。

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                |
| --------- | ------- | ---- | --- | ----------------- |
| `user`    | string  | ✅ 是  | -   | 个人资料 URL、URN 或用户名 |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）           |

**示例:**

```json theme={null}
{
  "user": "https://www.linkedin.com/in/username"
}
```

***

## Instagram

**数据源:** `instagram` | **类别:** `post`, `search`, `user`

### 帖子与内容

**类别:** `post`

#### `get_instagram_post`

获取 Instagram 帖子的详细信息。

**描述**: 通过 ID 获取 Instagram 帖子

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `post`    | string  | ✅ 是  | -   | 帖子 ID       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "post": "CxOTF-..."
}
```

***

#### `get_instagram_post_comments`

获取 Instagram 帖子的评论。

**描述**: 获取 Instagram 帖子评论

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `post`    | string  | ✅ 是  | -   | 帖子 ID       | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "post": "CxOTF-...",
  "count": 50
}
```

***

#### `get_instagram_post_likes`

获取 Instagram 帖子的点赞。

**描述**: 获取 Instagram 帖子点赞

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `post`    | string  | ✅ 是  | -   | 帖子 ID       | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "post": "CxOTF-...",
  "count": 100
}
```

***

#### `search_instagram_posts`

**类别:** `search`

按查询搜索 Instagram 帖子。

**描述**: 搜索 Instagram 帖子

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `query`   | string  | ✅ 是  | -   | 搜索查询        | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "nature photography",
  "count": 50
}
```

***

### 用户个人资料

**类别:** `user`

#### `get_instagram_user`

获取 Instagram 用户个人资料信息。

**描述**: 获取 Instagram 用户个人资料

**参数:**

| 参数                   | 类型      | 必填   | 默认值   | 描述                     | 约束                 |
| -------------------- | ------- | ---- | ----- | ---------------------- | ------------------ |
| `user`               | string  | ✅ 是  | -     | 用户 ID、别名或 URL          | -                  |
| `with_creation_date` | boolean | ❌ 可选 | false | 如果需要获取账户创建日期，请设置为 true | -                  |
| `timeout`            | integer | ❌ 可选 | 300   | 最大抓取执行超时（秒）            | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "natgeo",
  "with_creation_date": true
}
```

***

#### `get_instagram_user_friendships`

获取 Instagram 用户的关注者或正在关注列表。

**描述**: 获取 Instagram 用户关注关系

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述                            | 约束                 |
| --------- | ------- | ---- | --- | ----------------------------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户 ID、别名或 URL                 | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数                         | -                  |
| `type`    | string  | ✅ 是  | -   | 要获取的关系类型（followers/following） | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）                   | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "natgeo",
  "count": 100,
  "type": "followers"
}
```

***

#### `get_instagram_user_posts`

获取 Instagram 用户个人资料的帖子。

**描述**: 获取 Instagram 用户帖子

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述            | 约束                 |
| --------- | ------- | ---- | --- | ------------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户 ID、别名或 URL | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数         | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）   | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "natgeo",
  "count": 20
}
```

***

#### `get_instagram_user_reels`

获取 Instagram 用户个人资料的 Reels。

**描述**: 获取 Instagram 用户 Reels

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述            | 约束                 |
| --------- | ------- | ---- | --- | ------------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户 ID、别名或 URL | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数         | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）   | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "natgeo",
  "count": 10
}
```

***

## Twitter/X

**数据源:** `twitter` | **类别:** `search`, `user`, `user_tweets`

### 搜索与发现

**类别:** `search`

#### `search_twitter_posts`

使用高级过滤搜索 Twitter/X 帖子。

**描述**: 搜索 Twitter 帖子

**参数:**

| 参数                          | 类型      | 必填   | 默认值   | 描述                                           | 约束                 |
| --------------------------- | ------- | ---- | ----- | -------------------------------------------- | ------------------ |
| `count`                     | integer | ✅ 是  | -     | 最大结果数                                        | -                  |
| `query`                     | string  | ❌ 可选 | ""    | 主搜索查询。可以包含特殊运算符，如 from:user、to:user、#hashtag | -                  |
| `exact_phrase`              | string  | ❌ 可选 | ""    | 精确短语（在引号中）。将作为 "phrase" 添加到查询中               | -                  |
| `any_of_these_words`        | string  | ❌ 可选 | -     | 这些词中的任意一个（OR 条件）                             | -                  |
| `none_of_these_words`       | string  | ❌ 可选 | -     | 这些词中的任意一个都不包含（NOT 条件）                        | -                  |
| `these_hashtags`            | string  | ❌ 可选 | -     | 这些话题标签                                       | -                  |
| `language`                  | string  | ❌ 可选 | -     | 推文语言                                         | -                  |
| `from_these_accounts`       | string  | ❌ 可选 | -     | 来自这些账户                                       | -                  |
| `to_these_accounts`         | string  | ❌ 可选 | -     | 发送给这些账户                                      | -                  |
| `mentioning_these_accounts` | string  | ❌ 可选 | -     | 提及这些账户（带 @ 的用户名）                             | -                  |
| `min_replies`               | string  | ❌ 可选 | -     | 最小回复数                                        | -                  |
| `min_likes`                 | string  | ❌ 可选 | -     | 最小点赞数                                        | -                  |
| `min_retweets`              | string  | ❌ 可选 | -     | 最小转推数                                        | -                  |
| `from_date`                 | string  | ❌ 可选 | -     | 推文搜索的起始日期（时间戳）                               | -                  |
| `to_date`                   | string  | ❌ 可选 | -     | 推文搜索的结束日期（时间戳）                               | -                  |
| `search_type`               | string  | ❌ 可选 | "Top" | 搜索结果类型                                       | -                  |
| `timeout`                   | integer | ❌ 可选 | 300   | 最大抓取执行超时（秒）                                  | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "artificial intelligence",
  "min_likes": "100",
  "count": 50
}
```

***

#### `search_twitter_users`

搜索 Twitter/X 用户。

**描述**: 搜索 Twitter 用户

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `count`   | integer | ✅ 是  | -   | 最大结果数       | -                  |
| `query`   | string  | ❌ 可选 | ""  | 主搜索用户查询     | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "python developer",
  "count": 20
}
```

***

### 用户数据

**类别:** `user`

#### `get_twitter_user`

获取 Twitter/X 用户个人资料信息。

**描述**: 获取 Twitter 用户个人资料

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述          | 约束                 |
| --------- | ------- | ---- | --- | ----------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户别名或 URL   | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "elonmusk"
}
```

***

#### `get_twitter_user_posts`

获取 Twitter/X 用户的帖子。

**描述**: 获取 Twitter 用户帖子

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述            | 约束                 |
| --------- | ------- | ---- | --- | ------------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户 ID、别名或 URL | -                  |
| `count`   | integer | ✅ 是  | -   | 最大结果数         | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）   | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "elonmusk",
  "count": 20
}
```

***

#### `get_twitter_user_tweets`

获取 Twitter/X 用户的推文（备用端点）。

**描述**: 获取带扩展数据的 Twitter 用户推文

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述            | 约束                 |
| --------- | ------- | ---- | --- | ------------- | ------------------ |
| `user`    | string  | ✅ 是  | -   | 用户 ID、别名或 URL | -                  |
| `count`   | integer | ❌ 可选 | 10  | 最大结果数         | -                  |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）       | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "user": "elonmusk",
  "count": 20
}
```

***

## Reddit

**数据源:** `reddit` | **类别:** `search`, `posts`, `user`

### 搜索与内容

**类别:** `search`

#### `search_reddit_posts`

跨所有 subreddit 搜索 Reddit 帖子。

**描述**: 搜索 Reddit 帖子

**参数:**

| 参数            | 类型      | 必填   | 默认值         | 描述          | 约束                 |
| ------------- | ------- | ---- | ----------- | ----------- | ------------------ |
| `query`       | string  | ✅ 是  | -           | 主搜索查询       | -                  |
| `count`       | integer | ✅ 是  | -           | 最大结果数       | -                  |
| `sort`        | string  | ❌ 可选 | "relevance" | 搜索结果排序类型    | -                  |
| `time_filter` | string  | ❌ 可选 | "all"       | 搜索结果的时间过滤器  | -                  |
| `timeout`     | integer | ❌ 可选 | 300         | 最大抓取执行超时（秒） | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "query": "machine learning",
  "sort": "relevance",
  "time_filter": "week",
  "count": 50
}
```

***

#### `get_reddit_post`

获取 Reddit 帖子的详细信息。

**描述**: 获取 Reddit 帖子详情

**参数:**

| 参数         | 类型      | 必填   | 默认值 | 描述                                                                 | 约束                 |
| ---------- | ------- | ---- | --- | ------------------------------------------------------------------ | ------------------ |
| `post_url` | string  | ✅ 是  | -   | Reddit 帖子 URL 或路径（例如 /r/DogAdvice/comments/1o2g2pq/title/ 或完整 URL） | -                  |
| `timeout`  | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）                                                        | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "post_url": "https://www.reddit.com/r/Python/comments/..."
}
```

***

#### `get_reddit_post_comments`

获取 Reddit 帖子的评论。

**描述**: 获取 Reddit 帖子评论

**参数:**

| 参数         | 类型      | 必填   | 默认值 | 描述                | 约束                 |
| ---------- | ------- | ---- | --- | ----------------- | ------------------ |
| `post_url` | string  | ✅ 是  | -   | Reddit 帖子 URL 或路径 | -                  |
| `timeout`  | integer | ❌ 可选 | 300 | 最大抓取执行超时（秒）       | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "post_url": "https://www.reddit.com/r/Python/comments/..."
}
```

***

### 用户数据

**类别:** `user`

#### `get_reddit_user_posts`

获取 Reddit 用户的帖子。

**描述**: 获取 Reddit 用户的发帖历史

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述              |
| --------- | ------- | ---- | --- | --------------- |
| `user`    | string  | ✅ 是  | -   | Reddit 用户名或 URL |
| `count`   | integer | ❌ 可选 | 10  | 最大结果数           |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）         |

**示例:**

```json theme={null}
{
  "user": "spez",
  "count": 20
}
```

***

#### `get_reddit_user_comments`

获取 Reddit 用户的评论。

**描述**: 获取 Reddit 用户的评论历史

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述              |
| --------- | ------- | ---- | --- | --------------- |
| `user`    | string  | ✅ 是  | -   | Reddit 用户名或 URL |
| `count`   | integer | ❌ 可选 | 10  | 最大结果数           |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）         |

**示例:**

```json theme={null}
{
  "user": "spez",
  "count": 20
}
```

***

#### `get_reddit_user`

获取 Reddit 用户个人资料信息。

**描述**: 获取 Reddit 用户个人资料数据

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述              |
| --------- | ------- | ---- | --- | --------------- |
| `user`    | string  | ✅ 是  | -   | Reddit 用户名或 URL |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）         |

**示例:**

```json theme={null}
{
  "user": "spez"
}
```

***

#### `get_reddit_user_comments_extended`

获取 Reddit 用户的扩展评论数据。

**描述**: 获取带附加元数据的 Reddit 用户评论

**参数:**

| 参数        | 类型      | 必填   | 默认值 | 描述              |
| --------- | ------- | ---- | --- | --------------- |
| `user`    | string  | ✅ 是  | -   | Reddit 用户名或 URL |
| `count`   | integer | ❌ 可选 | 10  | 最大结果数           |
| `timeout` | integer | ❌ 可选 | 300 | 请求超时（秒）         |

**示例:**

```json theme={null}
{
  "user": "spez",
  "count": 20
}
```

***

## Web Parser

**数据源:** `webparser` | **类别:** `parse`, `sitemap`

### 页面提取

**类别:** `parse`

#### `parse_webpage`

解析并从任意网页中提取内容，并提供灵活的过滤选项。

**描述**: 解析并从网页中提取内容，并提供灵活的过滤选项

**参数:**

| 参数                     | 类型             | 必填   | 默认值   | 描述                                                 | 约束                 |
| ---------------------- | -------------- | ---- | ----- | -------------------------------------------------- | ------------------ |
| `url`                  | string         | ✅ 是  | -     | 要解析的页面 URL                                         | -                  |
| `include_tags`         | array\[string] | ❌ 可选 | -     | 要包含的元素的 CSS 选择器（仅保留这些）                             | -                  |
| `exclude_tags`         | array\[string] | ❌ 可选 | -     | 要排除的元素的 CSS 选择器或通配符掩码。示例: '.sidebar'、'*promo*'     | -                  |
| `only_main_content`    | boolean        | ❌ 可选 | false | 仅提取页面的主要内容（启发式算法）                                  | -                  |
| `remove_comments`      | boolean        | ❌ 可选 | true  | 移除 HTML 注释                                         | -                  |
| `resolve_srcset`       | boolean        | ❌ 可选 | true  | 将图像 srcset 转换为 src（选择最大的图像）                        | -                  |
| `return_full_html`     | boolean        | ❌ 可选 | false | 返回完整的 HTML 文档（True）或仅返回 body 内容（False）             | -                  |
| `min_text_block`       | integer        | ❌ 可选 | 200   | 主要内容检测的最小文本块大小（以字符为单位）                             | -                  |
| `remove_base64_images` | boolean        | ❌ 可选 | true  | 移除 base64 编码的图像（减小输出大小）                            | -                  |
| `strip_all_tags`       | boolean        | ❌ 可选 | false | 移除所有 HTML 标签，仅返回纯文本                                | -                  |
| `extract_contacts`     | boolean        | ❌ 可选 | false | 从页面中提取链接、电子邮件和电话号码                                 | -                  |
| `same_origin_links`    | boolean        | ❌ 可选 | false | 仅提取来自同一域的链接（与 extract\_contacts 一起使用）              | -                  |
| `social_links_only`    | boolean        | ❌ 可选 | false | 仅提取社交媒体链接（LinkedIn、Twitter/X、Facebook、Instagram 等） | -                  |
| `timeout`              | integer        | ❌ 可选 | 300   | 最大抓取执行超时（秒）                                        | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "url": "https://example.com/article",
  "only_main_content": true,
  "strip_all_tags": true,
  "extract_contacts": true
}
```

**使用场景:**

* 文章内容提取
* 联系信息收集
* 社交媒体链接发现
* 网页抓取和数据收集

***

#### `get_sitemap`

获取并解析网站站点地图，并提供过滤选项。

**描述**: 获取并解析网站站点地图，并提供过滤选项

**参数:**

| 参数                 | 类型             | 必填   | 默认值   | 描述                                              | 约束                 |
| ------------------ | -------------- | ---- | ----- | ----------------------------------------------- | ------------------ |
| `url`              | string         | ✅ 是  | -     | 要获取站点地图的网站 URL                                  | -                  |
| `include_patterns` | array\[string] | ❌ 可选 | -     | 要包含的 URL 路径的正则表达式模式（未指定则包含所有 URL）               | -                  |
| `exclude_patterns` | array\[string] | ❌ 可选 | -     | 要排除的 URL 路径的正则表达式模式                             | -                  |
| `same_host_only`   | boolean        | ❌ 可选 | true  | 仅包含与基础 URL 相同主机的 URL                            | -                  |
| `respect_robots`   | boolean        | ❌ 可选 | true  | 检查 robots.txt 并遵守被禁止的 URL                       | -                  |
| `count`            | integer        | ❌ 可选 | -     | 要返回的最大 URL 数                                    | -                  |
| `return_details`   | boolean        | ❌ 可选 | false | 返回详细的站点地图条目（lastmod、changefreq、priority）而非仅 URL | -                  |
| `timeout`          | integer        | ❌ 可选 | 300   | 最大抓取执行超时（秒）                                     | Min: 20, Max: 1500 |

**示例:**

```json theme={null}
{
  "url": "https://example.com",
  "count": 100,
  "return_details": true
}
```

**使用场景:**

* 网站结构分析
* 内容清单
* SEO 审计
* 批量 URL 提取

***

<Card title="其他数据源（~100 个端点）" icon="grid-2" href="/zh/data-sources">
  Product Hunt、Google（Maps 与 Ads）、Amazon、Facebook Ads、TikTok、Yahoo、Companies House、Crunchbase、GitHub 以及 20+ 个更多数据源 — 完整列表请参阅通俗易懂的 [数据源与功能](/zh/data-sources) 页面
</Card>

***

## 通用参数

大多数端点共享这些通用参数:

| 参数        | 类型      | 默认值 | 描述        | 约束                 |
| --------- | ------- | --- | --------- | ------------------ |
| `timeout` | integer | 300 | 最大执行超时（秒） | Min: 20, Max: 1500 |

<Tip>
  **超时最佳实践:**

  * 大多数操作使用默认的 300 秒
  * 对于大型数据提取，增加到 600-900 秒
  * 仅在快速测试时使用最小的 20 秒
  * 对于非常大的数据集，最大 1500 秒（25 分钟）
</Tip>

***

## LinkedIn URN 格式

<Note>
  许多 LinkedIn 端点需要 **URN（统一资源名称）** 标识符。URN 可通过搜索端点获取。
</Note>

**URN 类型:**

* **个人资料 URN**: `urn:li:fsd_profile:ACoAAABCDEF`
  * 获取来源: `search_linkedin_users`、`get_linkedin_profile`

* **公司 URN**: `urn:li:company:1234`
  * 获取来源: `search_linkedin_companies`、`get_linkedin_company`

* **活动 URN**（帖子）: `urn:li:activity:1234567890`
  * 获取来源: `search_linkedin_posts`、`get_linkedin_user_posts`

**获取 URN:**

1. 使用合适的搜索工具搜索资源
2. 从搜索结果中提取 URN
3. 在后续的数据提取端点中使用 URN

**示例工作流程:**

```text theme={null}
1. search_linkedin_users → get profile URN
2. get_linkedin_user_posts → get post URNs
3. get_linkedin_post_comments → get comments using post URN
```

***

## 最佳实践

### 速率限制

<CardGroup cols={2}>
  <Card title="遵守限制" icon="gauge">
    监控您的 API 使用情况，以保持在配额限制内。明智地使用 `count` 参数。
  </Card>

  <Card title="批量操作" icon="layer-group">
    尽可能合并多个操作，而非进行单独的调用。
  </Card>

  <Card title="超时管理" icon="clock">
    根据预期的数据量设置合适的超时。不要不必要地使用最大超时。
  </Card>

  <Card title="错误处理" icon="triangle-exclamation">
    为生产环境使用实现适当的错误处理和重试逻辑。
  </Card>
</CardGroup>

### 数据提取

<Accordion title="高效工作流程">
  **应该:**

  * 从 `discover()` 开始查找可用端点，然后使用搜索端点查找相关资源
  * 使用可选参数仅提取所需数据
  * 使用过滤器缩小结果范围
  * 设置合理的 count 限制

  **不应该:**

  * 在不需要时提取所有可用数据
  * 进行冗余的 API 调用
  * 忽略分页选项
  * 默认使用最大 count
</Accordion>

<Accordion title="LinkedIn 最佳实践">
  * 始终先通过搜索端点获取 URN
  * 使用可选的布尔参数（`with_experience`、`with_skills`）控制数据量
  * 利用地点/行业 URN 过滤器进行精确定位
  * 使用带方括号的 `keywords` 进行精确匹配: `"[software engineer]"`
</Accordion>

<Accordion title="Instagram 与 Twitter">
  * 用户标识符可以是用户名、URL 或 ID
  * 对于历史数据，在可用时使用时间戳过滤器
  * 帖子 ID 是平台特定的格式
  * 考虑互动指标以进行内容分析
</Accordion>

<Accordion title="网页解析">
  * 使用 `only_main_content=true` 进行文章提取
  * 利用 `exclude_tags` 移除广告/导航
  * 启用 `extract_contacts` 进行潜在客户开发
  * 设置 `strip_all_tags=true` 以输出纯文本
</Accordion>

### 安全性

<Warning>
  * 切勿将 API 密钥或凭据提交到版本控制
  * 对敏感数据使用环境变量
  * 定期监控 API 使用情况
  * 定期轮换密钥
  * 遵守平台服务条款
</Warning>

***

## 端点统计

**端点总数**: 跨 450+ 个数据源的 1,100+ 个

**MCP 工具**: 5 个元工具（discover、execute、get\_page、query\_cache、export\_data）

**按平台分类:**

* **LinkedIn**: 35 个端点 — 最全面（个人资料、公司、帖子、技能、经历）
* **Product Hunt**: 23 个端点 — 产品、发布、创客、合集、主题
* **YouTube**: 14 个端点
* **Reddit**: 11 个端点
* **Google**: 10 个端点 — Maps 与 Ads 透明度
* **Instagram**: 8 个端点
* **Companies House**: 8 个端点 — 英国官方登记处
* **Yahoo**: 7 个端点 — 搜索与财经
* **Amazon**: 5 个端点
* **Facebook**: 5 个端点 — 广告库
* **TikTok**: 5 个端点
* **Twitter/X**: 4 个端点
* **Y Combinator**: 3 个端点
* **Crunchbase**: 3 个端点
* **GitHub**: 3 个端点
* **SEC**: 2 个端点
* **Web Parser**: 2 个端点
* **DuckDuckGo**: 1 个端点
* **其他数据源**: 跨小众和基于 AI 的抓取器的 \~30 个端点（Capterra、G2、Mercari、OpenCorporates、Siemens、Honeywell 等）

**按类别分类:**

* **搜索与发现**: 40+ 个端点（人员、公司、帖子、视频、产品、网络）
* **用户与个人资料数据**: 30+ 个端点（个人资料、技能、经历、教育、认证）
* **内容与帖子**: 30+ 个端点（社交帖子、视频、发布、评测）
* **评论与互动**: 15+ 个端点
* **公司与登记数据**: 25+ 个端点（LinkedIn、YC、Crunchbase、SEC、Companies House）
* **文档与媒体提取**: 5+ 个端点（SEC 文档、YouTube 字幕、网页）
* **市场与广告**: 20+ 个端点（Amazon、Mercari、Facebook 与 Google Ads）

***

## 使用示例

### LinkedIn 研究工作流程（使用 query\_cache）

```text theme={null}
1. discover("linkedin", "search")
   → Get available search endpoints and parameters

2. execute("linkedin", "search", "search_users", {keywords: "CTO", location: "San Francisco", count: 50})
   → Get list of CTOs in SF + cache_key

3. query_cache(cache_key, conditions=[{field: "followers", op: ">", value: 1000}])
   → Filter only profiles with 1000+ followers (without loading all 50 into context)

4. execute("linkedin", "user", "get", {user: profile_url})
   → Extract detailed profile information

5. export_data(cache_key, "csv")
   → Download full search results as CSV
```

### Instagram 网红分析

```text theme={null}
1. execute("instagram", "user", "get", {user: "username"})
   → Get profile metrics

2. execute("instagram", "user", "posts", {user: "username", count: 20})
   → Extract recent posts + cache_key

3. query_cache(cache_key, aggregate={field: "likes", op: "avg"})
   → Calculate average likes per post (server-side)

4. query_cache(cache_key, sort_by="likes", sort_order="desc", limit=5)
   → Get top 5 posts by engagement
```

### Reddit 内容监测

```text theme={null}
1. execute("reddit", "search", "search_posts", {query: "product name", time_filter: "week"})
   → Find relevant discussions + cache_key

2. query_cache(cache_key, sort_by="score", sort_order="desc", limit=10)
   → Get top 10 posts by score

3. execute("reddit", "posts", "get_comments", {post_url: url})
   → Extract all comments
```

### YouTube 视频研究

```text theme={null}
1. execute("youtube", "search", "search_videos", {query: "AI tutorial", count: 50})
   → Find relevant videos + cache_key

2. query_cache(cache_key, sort_by="view_count", sort_order="desc", limit=10)
   → Top 10 by views

3. execute("youtube", "video", "get_subtitles", {video: "video_id", lang: "en"})
   → Get full video transcript
```

### SEC 财务分析

```text theme={null}
1. execute("sec", "search", "search_companies", {entity_name: "Tesla", forms: ["10-K", "10-Q"]})
   → Find recent financial filings

2. execute("sec", "document", "get", {document_url: filing_url})
   → Retrieve full 10-K report
```

***

## 需要帮助？

<CardGroup cols={2}>
  <Card title="文档" icon="book" href="/zh/introduction">
    全面的指南和教程
  </Card>

  <Card title="API 参考" icon="code" href="/api-reference">
    完整的 REST API 文档
  </Card>

  <Card title="MCP 集成" icon="puzzle-piece" href="/zh/mcp-server/claude-desktop-tool/installation">
    不同客户端的设置指南
  </Card>

  <Card title="支持" icon="headset" href="mailto:support@anysite.io">
    联系我们的支持团队
  </Card>
</CardGroup>