> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# 可用的 MCP 端点

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

## 端点参考

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

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

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

## 快速导航

- [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
{
  "query": "fastapi tutorial",
  "count": 15,
  "request_timeout": 300
}
```

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

---

## Y Combinator

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

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

### `get_yc_company`

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

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "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
{
  "query": "Sam Altman",
  "industries": ["AI", "Enterprise"],
  "top_company": true,
  "hits_per_page": 20,
  "timeout": 300
}
```

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

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

---

## YouTube

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

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

### `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
{
  "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
{
  "video": "dQw4w9WgXcQ",
  "timeout": 300
}
```

或使用完整 URL:
```json
{
  "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
{
  "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
{
  "channel": "https://www.youtube.com/@mkbhd",
  "count": 30,
  "timeout": 300
}
```

或使用频道别名:
```json
{
  "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
{
  "video": "dQw4w9WgXcQ",
  "count": 100,
  "timeout": 300
}
```

或使用完整 URL:
```json
{
  "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "count": 50
}
```

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

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

---

## SEC

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

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

### `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
{
  "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
{
  "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`

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

### 搜索与发现

**类别:** `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
{
  "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
{
  "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
{
  "name": "Stanford University",
  "count": 10
}
```

---

#### `search_linkedin_industries`

在 LinkedIn 上搜索行业。

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

**参数:**

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

**示例:**
```json
{
  "name": "Software",
  "count": 10
}
```

---

#### `search_linkedin_locations`

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

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "query": "OpenAI",
  "count": 5
}
```

---

### 个人资料详情

**类别:** `user`

#### `get_linkedin_user_experience`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_education`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_skills`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_endorsers`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_certificates`

获取 LinkedIn 个人资料的认证。

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_honors`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_languages`

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

**参数:**

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

**示例:**
```json
{
  "user": "https://www.linkedin.com/in/username"
}
```

---

#### `get_linkedin_user_patents`

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "post": "CxOTF-..."
}
```

---

#### `get_instagram_post_comments`

获取 Instagram 帖子的评论。

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

**参数:**

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

**示例:**
```json
{
  "post": "CxOTF-...",
  "count": 50
}
```

---

#### `get_instagram_post_likes`

获取 Instagram 帖子的点赞。

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

**参数:**

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

**示例:**
```json
{
  "post": "CxOTF-...",
  "count": 100
}
```

---

#### `search_instagram_posts`

**类别:** `search`

按查询搜索 Instagram 帖子。

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "query": "python developer",
  "count": 20
}
```

---

### 用户数据

**类别:** `user`

#### `get_twitter_user`

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

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

**参数:**

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

**示例:**
```json
{
  "user": "elonmusk"
}
```

---

#### `get_twitter_user_posts`

获取 Twitter/X 用户的帖子。

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "user": "spez",
  "count": 20
}
```

---

#### `get_reddit_user_comments`

获取 Reddit 用户的评论。

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

**参数:**

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

**示例:**
```json
{
  "user": "spez",
  "count": 20
}
```

---

#### `get_reddit_user`

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

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

**参数:**

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

**示例:**
```json
{
  "user": "spez"
}
```

---

#### `get_reddit_user_comments_extended`

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

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

**参数:**

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

**示例:**
```json
{
  "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
{
  "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
{
  "url": "https://example.com",
  "count": 100,
  "return_details": true
}
```

**使用场景:**
- 网站结构分析
- 内容清单
- SEO 审计
- 批量 URL 提取

---

#### 其他数据源（~100 个端点）

  Product Hunt、Google（Maps 与 Ads）、Amazon、Facebook Ads、TikTok、Yahoo、Companies House、Crunchbase、GitHub 以及 20+ 个更多数据源 — 完整列表请参阅通俗易懂的 [数据源与功能](/docs/data-sources?lang=zh) 页面

---

## 通用参数

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

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

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

---

## LinkedIn URN 格式

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

**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
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
```

---

## 最佳实践

### 速率限制

  
#### 遵守限制

    监控您的 API 使用情况，以保持在配额限制内。明智地使用 `count` 参数。
  

  
#### 批量操作

    尽可能合并多个操作，而非进行单独的调用。
  

  
#### 超时管理

    根据预期的数据量设置合适的超时。不要不必要地使用最大超时。
  

  
#### 错误处理

    为生产环境使用实现适当的错误处理和重试逻辑。
  

### 数据提取

#### 高效工作流程

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

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

#### LinkedIn 最佳实践

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

#### Instagram 与 Twitter

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

#### 网页解析

  - 使用 `only_main_content=true` 进行文章提取
  - 利用 `exclude_tags` 移除广告/导航
  - 启用 `extract_contacts` 进行潜在客户开发
  - 设置 `strip_all_tags=true` 以输出纯文本

### 安全性

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

---

## 端点统计

**端点总数**: 跨 600+ 个数据源的 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
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
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
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
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
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
```

---

## 需要帮助？

  
#### 文档

    全面的指南和教程
  

  
#### API 参考

    完整的 REST API 文档
  

  
#### MCP 集成

    不同客户端的设置指南
  

  
#### 支持

    联系我们的支持团队