linkedin-browser-mcp-server

🚀 LinkedIn 浏览器 MCP 服务器

这是一个基于 FastMCP 的服务器，借助浏览器自动化技术，可用于 LinkedIn 的自动化操作和数据提取。该服务器提供了一系列工具，能让你与 LinkedIn 进行程序化交互，同时严格遵守 LinkedIn 的服务条款和速率限制。

🚀 快速开始

此服务器允许你使用浏览器自动化与 LinkedIn 进行交互，同时遵守 LinkedIn 的服务条款和速率限制。以下是启动服务器并开始使用所需的步骤。

✨ 主要特性

安全认证

• 环境基于凭据管理，保障登录信息安全。
• 带有加密 cookie 存储的会话持久性，确保会话安全不丢失。
• 具备防止速率限制保护机制，避免因频繁请求被限制。
• 支持自动会话恢复，提升使用的便捷性。

个人资料操作

• 可查看并提取个人资料信息，方便获取所需数据。
• 能根据关键字搜索个人资料，精准定位目标。
• 支持浏览 LinkedIn 动态 feeds，掌握最新动态。
• 可访问个人资料功能，深入了解用户信息。

帖子交互

• 可以喜欢帖子，表达对内容的认可。
• 能在帖子上评论，参与互动交流。
• 可阅读帖子内容和参与度指标，了解帖子热度。

📦 安装指南

先决条件

• Python 3.8+
• Playwright
• FastMCP 库
• LinkedIn 账户

安装步骤

1. 克隆仓库：

git clone [仓库地址]
cd mcp-linkedin-server

2. 创建并激活虚拟环境：

python -m venv env
source env/bin/activate  # 在 Windows 上：env\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt
playwright install chromium

4. 设置环境变量： 创建根目录中的 .env 文件，内容如下：

LINKEDIN_USERNAME=your_email@example.com
LINKEDIN_PASSWORD=your_password
COOKIE_ENCRYPTION_KEY=your_encryption_key  # 可选：如果未提供将自动生成

💻 使用示例

基础用法

from fastmcp import FastMCP

# 初始化客户端
client = FastMCP.connect("http://localhost:8000")

# 登录
result = await client.login_linkedin_secure()
print(result)

# 搜索个人资料
profiles = await client.search_linkedin_profiles(
    query="software engineer",
    count=5
)
print(profiles)

# 查看个人资料
profile_data = await client.view_linkedin_profile(
    profile_url="https://www.linkedin.com/in/username"
)
print(profile_data)

高级用法

1. 启动 MCP 服务器：

python linkedin_browser_mcp.py

2. 可用工具：

• login_linkedin_secure：使用环境凭据安全登录
• browse_linkedin_feed：浏览和提取 feed 中的帖子
• search_linkedin_profiles：搜索符合标准的个人资料
• view_linkedin_profile：查看并提取特定个人资料的数据
• interact_with_linkedin_post： liking、评论或阅读帖子

📚 详细文档

安全特性

• 加密 cookie 存储，保护用户隐私。
• 防止速率限制保护，确保服务稳定。
• 凭据安全管理，保障账户安全。
• 会话持久性，提升使用体验。
• 浏览器自动化安全措施，防止信息泄露。

最佳实践

防止速率限制

服务器实现了防止过多请求的功能：

• 每小时最多 5 次登录尝试，避免频繁登录被限制。
• 自动会话重用，减少不必要的登录操作。
• Cookie 持久化以减少登录需求，提高使用效率。

错误处理

全面的错误处理针对：

• 网络问题，确保在网络不稳定时能正常处理。
• 认证失败，提供相应的解决方案。
• LinkedIn 安全挑战，保障账户安全。
• 无效 URL 或参数，避免因输入错误导致程序异常。

会话管理

• 自动加密 cookie，保护会话信息安全。
• 会话持久性，确保会话不丢失。
• 安全存储实践，防止数据泄露。

贡献指南

1. 叉仓库
2. 创建功能分支
3. 提交你的更改
4. 推送到分支
5. 创建拉取请求

📄 许可证

MIT

免责声明

⚠️ 重要提示

此工具仅用于教育目的。在使用此软件时，请确保符合 LinkedIn 的服务条款和速率限制指南。