内容
# Unipile LinkedIn MCP 服务器
一款功能齐全的 [模型上下文协议（MCP）](https://modelcontextprotocol.io/) 服务器，用于 Unipile LinkedIn API。使 AI 助手能够与 LinkedIn 进行交互，实现搜索、消息传递、联系人管理和销售导航等功能。
## 功能
- **LinkedIn 搜索** - 使用经典和销售导航过滤器搜索人员、公司和帖子
- **个人资料管理** - 查看个人资料、公司页面和您自己的个人资料
- **联系人** - 发送/接受/拒绝邀请，列出联系人
- **消息传递** - 列出聊天记录、发送消息、开始对话
- **InMail** - 向非联系人发送 InMail（高级/销售导航）
- **销售导航** - 高级过滤器，如任职时间、资历、公司规模
## 安装
### 使用 uvx（推荐）
```bash
uvx unipile-linkedin-mcp
```
### 使用 pip
```bash
pip install unipile-linkedin-mcp
```
## 配置
### 环境变量
在运行之前设置以下环境变量：
```bash
export UNIPILE_API_KEY="your-api-key"
export UNIPILE_BASE_URL="https://api13.unipile.com:14376/api/v1"
export UNIPILE_ACCOUNT_ID="your-account-id"
```
或在工作目录中创建 `.env` 文件。
### Claude Desktop 配置
将以下内容添加到您的 Claude Desktop 配置文件（`~/Library/Application Support/Claude/claude_desktop_config.json` 在 macOS 上）：
```json
{
"mcpServers": {
"unipile-linkedin": {
"command": "uvx",
"args": ["unipile-linkedin-mcp"],
"env": {
"UNIPILE_API_KEY": "your-api-key",
"UNIPILE_BASE_URL": "https://api13.unipile.com:14376/api/v1",
"UNIPILE_ACCOUNT_ID": "your-account-id"
}
}
}
}
```
## 可用工具（共 22 个）
### 搜索
| 工具 | 描述 |
|------|-------------|
| `search_people` | 使用经典 LinkedIn 过滤器搜索人员 |
| `search_people_sales_nav` | 使用销售导航高级过滤器搜索 |
| `search_companies` | 搜索公司 |
| `search_posts` | 搜索 LinkedIn 帖子/内容 |
| `get_search_params` | 获取有效的过滤器 ID（位置、行业等） |
### 个人资料
| 工具 | 描述 |
|------|-------------|
| `list_accounts` | 列出所有连接的 LinkedIn 账户 |
| `get_my_profile` | 获取认证用户的个人资料 |
| `get_profile` | 获取任何用户的完整个人资料 |
| `get_company_profile` | 获取公司页面详情 |
### 联系人
| 工具 | 描述 |
|------|-------------|
| `send_invitation` | 发送连接请求（最大 300 字符消息） |
| `list_invitations_sent` | 查看待处理的 outbound 邀请 |
| `list_invitations_received` | 查看 inbound 连接请求 |
| `accept_invitation` | 接受连接请求 |
| `decline_invitation` | 拒绝连接请求 |
| `cancel_invitation` | 撤销已发送的邀请 |
| `list_relations` | 列出 1 度连接 |
### 消息传递
| 工具 | 描述 |
|------|-------------|
| `list_chats` | 列出消息对话 |
| `get_chat_messages` | 获取聊天消息 |
| `send_message` | 在现有聊天中发送消息 |
| `start_chat` | 与连接者启动新对话 |
### InMail（高级）
| 工具 | 描述 |
|------|-------------|
| `send_inmail` | 向非连接者发送 InMail |
| `get_inmail_credits` | 检查剩余的 InMail 积分 |
## 使用示例
### 搜索人员
```python
# 经典 LinkedIn 搜索
search_people(keywords="软件工程师", location=["103644278"], limit=10)
# 销售导航搜索，包含高级过滤器
search_people_sales_nav(
keywords="CTO",
company_headcount=[{"min": 51, "max": 200}],
changed_jobs=True,
seniority_level=["Director", "VP"]
)
```
### 获取搜索参数 ID
```python
# 查找位置 ID
get_search_params(param_type="LOCATION", query="旧金山")
# 查找行业 ID
get_search_params(param_type="INDUSTRY", query="软件")
```
### 发送连接请求
```python
send_invitation(
provider_id="ACoAAB...",
message="您好！我想与您联系。"
)
```
### 启动对话
```python
# 与 1 度连接者
start_chat(
attendees_ids=["ACoAAB..."],
text="您好！很高兴与您联系。"
)
# 向非连接者发送 InMail（需要积分）
send_inmail(
attendees_ids=["ACoAAB..."],
subject="快速问题",
text="您好，我注意到您的工作是..."
)
```
## 获取 Unipile 凭证
1. 在 [Unipile](https://unipile.com/) 注册
2. 连接您的 LinkedIn 账户
3. 从仪表盘获取您的 API 密钥和账户 ID
4. 记录您的基准 URL（因地区而异）
## 速率限制
Unipile 建议以下每日限制：
- 个人资料查看：80-100/天（经典），150/天（销售导航）
- 邀请：80-100/天（付费），15/周（免费）
- 消息：100-150/天
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 了解详情。
## 贡献
欢迎贡献！请在 GitHub 上提出问题或提交 PR。
