使用说明
LinkedIn Easy MCP服务器v2.0.0
现代化的模型上下文协议 (MCP) 服务器,可使用 OpenID Connect 和最新 API (2024/2025) 管理您的 LinkedIn 帐户。
🚀 v2.0.0 新闻
- ✅ OpenID连接现代、安全的身份验证
- ✅ API领英v2024.04最新版本
- ✅ 上传图像直接发布图片
- ✅ 最佳 UX更清晰的错误消息
- ✅ 速率限制最新限制信息
- ✅ TypeScript:代码完成提示
🎯 可用功能
✅ 总是工作(基本令牌)
- **
test_connection**测试与LinkedIn API的连接 - **
get_profile**通过 OpenID Connect 获取配置文件信息 validate_token: 检查令牌是否有效- **
get_token_info**关于令牌和范围的详细信息
⚠️ 需求范围 w_member_social
- **
create_text_post**创建文本帖子 - **
create_article_post**用文章/URL创建文章 - **
create_image_post**创建带有图像的帖子
❌ 需要LinkedIn合作伙伴(不可用)
- **
get_connections**列出连接 search_people: 寻找人- **
send_message**发送消息 like_post: 缩短帖子- **
comment_on_post**评论文章 get_profile_views:分析确实有效
📋 先决条件
- Node.js 18+
- 使用OpenID Connect的LinkedIn访问令牌
- 在 Developer Portal 中配置的 LinkedIn 应用程序
🛠️ 快速安装
- 克隆并安装:
git clone <repository-url>
cd linkedin-easy-mcp-server
npm install
- 配置令牌:
cp .env.example .env
# Edite .env e adicione seu LINKEDIN_ACCESS_TOKEN
- 编译和测试:
npm run build
npm run test:connection
- 执行:
npm start
🔑 如何从LinkedIn获得令牌
完整指南: 查看 LINKEDIN_SETUP.md 详细的指示。
快速摘要:
- Crie应用程序没有 LinkedIn开发者门户
- Adicione productos:“使用OpenID Connect登录LinkedIn”+“在LinkedIn上分享”
- 配置作用域:
openid,profile,email,w_member_social - 使用 OAuth 2.0 流来获取令牌
🎯 谎言
Como Servidor MCP
- 启动服务器:
npm start
- 不配置Claude桌面 (
claude_desktop_config.json):
{
"mcpServers": {
"linkedin": {
"command": "node",
"args": ["/caminho/para/linkedin-easy-mcp-server/dist/index.js"],
"env": {
"LINKEDIN_ACCESS_TOKEN": "seu_token_aqui"
}
}
}
}
使用范例
测试连接:
# Via npm script
npm run test:connection
# Via MCP
{
"tool": "test_connection",
"arguments": {}
}
创建文本帖子:
{
"tool": "create_text_post",
"arguments": {
"text": "Hello LinkedIn! 🚀",
"visibility": "PUBLIC"
}
}
Post with 文章:
{
"tool": "create_article_post",
"arguments": {
"text": "Confira este artigo interessante!",
"articleUrl": "https://example.com/artigo",
"articleTitle": "Título do Artigo",
"articleDescription": "Descrição do artigo"
}
}
张贴图片:
{
"tool": "create_image_post",
"arguments": {
"text": "Olha essa imagem!",
"imagePath": "/caminho/para/imagem.jpg",
"imageTitle": "Minha Foto"
}
}
📊 费率限制(2024/2025)
| 端点 | 限制 |
|---|---|
| OpenID连接 | membro每天500个请求 |
| 共享API | 每天150个请求 |
| 应用程序总计 | 100000个请求/天 |
🔧 可用脚本
npm run build # Compila TypeScript
npm run dev # Modo desenvolvimento (watch)
npm start # Inicia servidor MCP
npm run test:connection # Testa conexão LinkedIn
🛠️ 可用工具
✅ 始终可用
test_connection
测试与 LinkedIn API 的连接并显示令牌信息。
get_profile
通过 OpenID Connect 获取配置文件信息。
validate_token
检查访问令牌是否有效 。
get_token_info
返回关于令牌和范围的详细信息。
⚠️ 需求范围 w_member_social
create_text_post
在LinkedIn上创建文本帖子。
- 文本文章文本
- 可见性:
PUBLIC欧点CONNECTIONS
create_article_post
创建文章/URL。
- 文本文章文本
- 文章URL文章 URL
- 文章标题 (可选): 文章标题
- 文章描述 (可选): 产品描述
- 可见性:
PUBLIC欧点CONNECTIONS
create_image_post
创建一个带有图像的帖子。
- 文本文章文本
- imagePath图像的本地路径
- imageTitle (可选): 图像标题
- 图片描述 (可选): 图像描述
- 可见性:
PUBLIC欧点CONNECTIONS
❌ 功能受限
以下功能是 可在代码 但需要 LinkedIn特别批准:
get_connections- 列出连接search_people- 寻找人send_message- 发送消息like_post- 缩短帖子comment_on_post- 评论文章get_profile_views-分析确实有效
⚠️ 重要限制
LinkedIn API的变化(2024/2025)
- 限制访问大多数API都需要商业伙伴关系
- OpenID连接新建默认认证方式
- 速率限制基本应用的较低限制
- 范围有限可用权限较少
替代战略
对于不可用的功能,请考虑:
- Web剪贴使用像Puppeteer这样的库(小心ToS)
- 手动集成手动操作的接口
- 第三方 API像 LinkedIn 的 RapidAPI 这样的服务
- LinkedIn销售导航对于有高级需求的企业
🚨 故障排除
错误 : “ 令牌已过期 ”
# Gere um novo token seguindo LINKEDIN_SETUP.md
# Tokens LinkedIn expiram em 60 dias
错误:“范围不足”
# Verifique se adicionou w_member_social para posts
# Configure produtos no LinkedIn Developer Portal
错误 : “ 超出速率限制 ”
# Aguarde reset (24h) ou implemente retry com backoff
# Monitore uso via test_connection
📚 回顾
🤝 贡献
- 分叉工程
- 创建分支 :
git checkout -b feature/nova-funcionalidade - 承诺:
git commit -m 'Adiciona nova funcionalidade' - 推:
git push origin feature/nova-funcionalidade - 打开 Pull Request
📄 许可证
麻省理工学院许可证-veja 许可证 为了细节。
⭐ 支持
如果这个项目有帮助,请考虑⭐!
支持 :
- 🐛 问题:报告错误和建议
- 💬 讨论: 问题和想法
- 📧 电子邮件:私人问题
警告此项目与LinkedIn无正式关联。负责任地使用并遵守 LinkedIn 使用条款。