READMEmain
We couldn't render this README. Read it on GitHub
LinkedIn Company Verification MCP Server
基于Model Context Protocol (MCP)的LinkedIn公司页面验证服务。
功能概述
- 公司搜索:搜索公司的LinkedIn页面
- 并行网页爬取:批量爬取多个网页内容
- 智能验证:验证页面内容是否为目标公司的官方页面
⚠️ 重要提示:环境变量配置
本服务器必须配置以下环境变量才能正常工作:
必需的API密钥
SHANGJI_SERPER_DEV_WEB_SEARCH_KEY- Google搜索API密钥(使用Serper服务)OPENAI_API_KEY- OpenAI API密钥(用于验证功能)
推荐的代理配置(提高访问稳定性)
PROXY_SERVER- 代理服务器地址(如 "proxy.example.com:31212")PROXY_USERNAME- 代理用户名PROXY_PASSWORD- 代理密码
安装
- 克隆仓库:
git clone https://github.com/AshlynnLu/search-linkedin-mcp.git
cd search-linkedin-mcp
- 安装依赖:
npm install
- 编译TypeScript代码:
npm run build
- 确保安装Playwright浏览器(首次运行会自动安装):
npx playwright install chromium --with-deps
配置
在Claude Desktop中配置
编辑Claude Desktop配置文件:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"shangjitong": {
"command": "node",
"args": ["<项目路径>/build/index.js"],
"env": {
"SHANGJI_SERPER_DEV_WEB_SEARCH_KEY": "your-serper-api-key",
"OPENAI_API_KEY": "your-openai-api-key",
"PROXY_SERVER": "proxy.example.com:1234",
"PROXY_USERNAME": "username",
"PROXY_PASSWORD": "password"
}
}
}
}
在环境中直接设置
export SHANGJI_SERPER_DEV_WEB_SEARCH_KEY=your-serper-api-key
export OPENAI_API_KEY=your-openai-api-key
export PROXY_SERVER=proxy.example.com:1234
export PROXY_USERNAME=username
export PROXY_PASSWORD=password
npm run start
使用方法
启动服务器:
npm run start
或者直接运行脚本:
./scripts/start.sh
服务启动后,如果有任何环境变量未配置,会在日志中显示警告信息。
MCP工具功能
服务器提供以下MCP工具:
-
search_company: 搜索公司LinkedIn页面- 参数:
company_name(公司名称) - 返回: 搜索结果列表,包含URL、标题和摘要
- 参数:
-
crawl_multiple_pages: 并行爬取多个URL的页面内容- 参数:
urls(要爬取的URL列表) - 返回: 所有爬取的页面内容
- 参数:
-
verify_multiple_contents: 批量验证多个页面内容- 参数:
company_name,pages(URL和内容列表) - 返回: 所有验证结果和最佳匹配
- 参数:
-
verify_company: 完整验证流程,包括搜索、爬取和验证- 参数:
company_name,official_website(可选) - 返回: 验证结果,包含匹配的LinkedIn页面URL
- 参数:
日志
所有组件会生成单独的日志文件:
mcp-server.log: 主服务器日志crawler.log: 网页爬虫日志google.log: Google搜索日志llm.log: 大模型API日志
获取API密钥
- SerperDev API密钥:访问 https://serper.dev/ 注册账号获取
- OpenAI API密钥:访问 https://platform.openai.com/ 注册账号获取
故障排除
如果遇到问题:
- 检查各组件日志文件
- 确保所有环境变量都已正确配置
- 验证代理服务器连接是否正常
- 确认API密钥是否有效
许可
MIT License
