findscripter 何时使用
当你要从脚本或 AI Agent 编排 LinkedIn 操作（而非手点网页 UI）时使用本技能：
- 搭建外联、调研、招聘等依赖 LinkedIn 数据与私信的工作流。
- 批量抓取人/公司资料，做线索或客户富集。
- 编排多步 Sales Navigator 或自定义 workflow，需要 JSON 输出和退出码可判读。
不该用的边界：
- 需要即时返回结果时不要用——每次命令都驱动真实云端浏览器，耗时 30 秒到数分钟。
- 一次性手动浏览、不需要程序化输出时，直接用网页更合适。
- 缺少必要输入、权限、安全边界或成功标准时，先停下来向用户澄清，不要硬跑。
- 使用真实账号自动化时，必须遵守 LinkedIn 服务条款、当地法规及所在组织的合规政策。
步骤
- 确认工具：若
linkedin不可用，安装：npm install -g @linkedapi/linkedin-cli - 鉴权（命令返回退出码 2 时）：让用户到 app.linkedapi.io 注册/登录、连接 LinkedIn 账号，复制 Linked API Token 与 Identification Token，然后运行
linkedin setup --linked-api-token=TOKEN --identification-token=TOKEN。 - 执行命令：所有命令统一加
--json -q，便于机器解析。 - 判读结果：退出码 0 仅代表 API 调用成功，必须再看
success字段判断动作是否真的成功；非 0 退出码代表基础设施错误。
指令
全局标志（建议每条命令都带）：
| 标志 | 说明 |
|---|---|
--json |
结构化 JSON 输出 |
--quiet / -q |
抑制 stderr 进度信息 |
--fields name,url,... |
仅输出指定字段 |
--account "Name" |
指定账号执行本命令 |
输出格式：成功 { "success": true, "data": {...} }；失败 { "success": false, "error": { "type": "personNotFound", "message": "..." } }。
退出码：0 成功（仍需查 success）；1 一般错误；2 token 缺失/无效；3 需订阅/套餐；4 LinkedIn 账号问题；5 参数无效；6 限流；7 网络错误；8 workflow 超时（返回 workflowId 供恢复）。
核心命令一览：
- 抓取个人：
linkedin person fetch <url> [--experience --education --skills --languages --posts --posts-limit N --comments --reactions] --json -q（按需加标志，每个标志都增加耗时） - 搜索个人：
linkedin person search --term ... [--locations --industries --current-companies --previous-companies --schools --position --limit] --json -q - 抓取公司：
linkedin company fetch <url> [--employees --dms --posts]，员工过滤需配合--employees（如--employees-position、--employees-locations） - 搜索公司：
linkedin company search --term ... [--sizes "11-50,51-200" --locations --industries] --json -q - 发消息：
linkedin message send <person-url> '<text>' --json -q（文本 ≤1900 字符，单引号包裹） - 取会话：
linkedin message get <person-url> [--since TIMESTAMP] --json -q（首次会触发后台同步、较慢） - 人脉：
connection status|send|list|pending|withdraw|remove，如connection send <url> [--note '...'] [--email ...]；withdraw默认会同时取关，加--no-unfollow保留关注 - 帖子：
post fetch <url> [--comments --comments-sort mostRecent --comments-replies --reactions]；post create '<text>' [--company-url --attachments "url:type:name"]；post react <url> --type like|love|support|celebrate|insightful|funny；post comment <url> '<text>'（评论 ≤1000 字符） - 统计：
stats ssi/stats performance/stats usage --start ... --end ... - Sales Navigator（需订阅，使用哈希 URL）：
navigator person fetch|search、navigator company fetch|search、navigator message send <url> '<text>' --subject '<subject>'（InMail，正文 ≤1900、主题 ≤80）、navigator message get - 自定义工作流：
linkedin workflow run --file workflow.json --json -q（或 stdin/inline）；workflow status <id> [--wait] - 账号管理：
account list/account switch "Name"/account rename "Name" --name "New"/reset [--all]
示例
# 抓取个人资料 + 工作与教育经历
linkedin person fetch https://www.linkedin.com/in/username --experience --education --json -q
# 按公司与职位搜索人
linkedin person search --current-companies "Google" --position "Engineer" --limit 20 --json -q
# 抓公司的决策者和最近 10 条动态
linkedin company fetch https://www.linkedin.com/company/name --dms --posts --posts-limit 10 --json -q
# 发消息（单引号包裹文本）
linkedin message send https://www.linkedin.com/in/username 'Hey, loved your latest post!' --json -q
# 带文档附件发帖
linkedin post create 'Our Q4 report' \
--attachments "https://example.com/report.pdf:document:Q4 Report" --json -q
# Sales Navigator 发 InMail
linkedin navigator message send https://www.linkedin.com/in/username \
'Would love to chat about API integrations' --subject 'Partnership Opportunity' --json -q
注意事项
- 串行执行：同一账号的所有操作逐个排队执行，多请求会排队。
- 非即时：真实浏览器在导航 LinkedIn，单次操作 30 秒到数分钟。
- 时间均为 UTC：所有日期时间按 UTC 处理。
- 文本参数用单引号：消息、帖子、评论的文本用单引号包裹，避免 shell 解析特殊字符。
- 动作上限：每账号限额在平台侧可配；
limitExceeded错误代表已达上限。 - URL 归一化：响应中所有 LinkedIn URL 归一为
https://www.linkedin.com/...且无尾部斜杠。 - 空字段：不可用字段返回
null或[]，不会被省略。 - 附件限制：最多 9 张图，或 1 个视频，或 1 个文档；类型不可混用。
- 不要把输出当作环境特定校验/测试/专家评审的替代品。
互见
- 飞书侧的人脉/消息/外联场景可参考
lark-im、lark-contact等 lark-* 技能（不同平台，能力不互通）。 - 自定义 workflow JSON schema 见官方文档 https://linkedapi.io/docs/building-workflows/
采编自 sickn33/antigravity-awesome-skills（MIT）。