lhremote 是一个 CLI 与 MCP 服务器，用于 LinkedHelper 自动化。项目由 Alexey Pelykh 提供，目标是让 AI 助手（如 Claude）通过 Model Context Protocol 控制 LinkedIn 外联流程。
用途 它把 LinkedHelper 的常见操作封装为可供 AI 调用的工具或命令行命令，覆盖从应用管理到 LinkedIn 互动的多个环节，便于把 LinkedIn 外联流程接入 AI 助手的工作流。
主要能力
- 应用管理：检测、启动和退出 LinkedHelper 实例。
- 账户与实例控制：列出账户、启动/停止实例、检查状态。
- 活动自动化：创建、配置、启动、停止和监控活动，并管理完整的动作链。
- 人员导入：将 LinkedIn 个人主页 URL 导入活动目标列表。
- 资料查询：从本地数据库查找和搜索缓存的 LinkedIn 资料。
- 消息：发送私信、InMail 和连接请求，查询消息历史并检查回复。
- LinkedIn 互动：访问主页、认可技能、关注/取消关注、点赞帖子、评论和表态。
- 信息流与帖子智能：读取 LinkedIn 信息流、搜索帖子、获取帖子详情、互动统计和互动者列表。
- 资料补充：从 LinkedIn 资料中提取邮箱、电话、社交媒体和公司数据。
- LinkedIn 搜索：构建搜索 URL、解析实体 ID，并查询搜索过滤器的参考数据。
- 预算与限流监控：检查每日操作限制和 LinkedIn 限流状态。
- 动作发现：列出可用的 LinkedHelper 动作类型及其配置模式。
使用方式 lhremote 需要 LinkedHelper 桌面应用（需付费订阅）。可通过 npx 直接运行。在 Claude Desktop 中使用时，将配置添加到 claude_desktop_config.json，之后 Claude 可直接使用每个已注册工具。典型工作流：find-app 检测运行中的 LinkedHelper 实例（或用 launch-app 启动）；list-accounts 查看可用 LinkedIn 账户；start-instance 为账户启动实例；describe-actions 探索可用动作类型；campaign-create 从 YAML/JSON 配置创建活动；import-people-from-urls 将目标 LinkedIn 资料导入活动；campaign-start 运行活动；campaign-status / campaign-statistics 监控进度；query-messages / check-replies 查看消息结果。
lhremote 命令提供与 MCP 服务器相同的功能。除参考部分另有说明外，每个 MCP 工具都有对应的 CLI 命令。
连接参数方面，大多数工具和 CLI 命令通过 Chrome DevTools Protocol（CDP）连接 LinkedHelper。cdpPort 是自动发现的，不是默认值：省略时 lhremote 会自行查找运行中的 LinkedHelper 端口，无论该端口是什么；当没有可达实例时会抛出 LinkedHelperNotRunningError 或 LinkedHelperUnreachableError。只有在需要定位特定实例时才传入端口。两个例外：quit-app 只接受 cdpPort（不接受 cdpHost、allowRemote 或 accountId），且默认使用 9222；当 cdpHost 非回环地址时，必须提供端口，因为发现过程只扫描本地进程。
accountId 在配置了多个账户后是必需的。只有一个账户时，MCP 工具会自行解析；有多个账户时它们无法解析，调用会失败——多数抛出 AccountResolutionError，start-instance 和 stop-instance 则返回自己的消息。无论哪种情况，list-accounts 都能给出 ID。每个连接到运行中 LinkedHelper 的工具都接受 accountId；不接受的是应用管理工具（find-app、launch-app、quit-app，它们作用于应用而非账户）、参考工具（build-linkedin-url、resolve-linkedin-entity、list-linkedin-reference-data、describe-actions，它们不打开连接）以及资料缓存读取器（query-profile、query-profiles、query-profiles-bulk，它们搜索所有账户的本地数据库，无法限定到单个账户）。CLI 在任何账户数量下都不会自动解析：start-instance / stop-instance 接受必需的位置参数 <accountId>，comment-on-post / react-to-post 接受 --account-id，其他命令不暴露该参数。
安全警告：启用 allowRemote 会允许 CDP 连接到远程主机。CDP 是一个不受沙箱限制的协议，会授予对目标浏览器的完全控制——等同于远程代码执行。仅当你的机器与目标主机之间的网络路径完全安全（例如 SSH 隧道、VPN 或可信 LAN）时才启用。
适用场景 适合需要借助 AI 助手批量或半自动执行 LinkedIn 外联、活动管理、资料查询与互动操作的场景，也适合通过 CLI 在脚本中调用相同能力。
限制 LinkedIn 会监控自动化活动，建议参考 Rate Limiting 指南设置节奏。部分操作会消耗每日操作预算。lhremote 需要 LinkedHelper 桌面应用且需要付费订阅。关于具体价格、套餐细节、平台支持范围等，资料暂未提供。
