用途:通过 Curviate CLI 读写 LinkedIn 收件箱与消息,并订阅消息、账号事件。命令面基于 CLI 0.33.0。
准备:npm install -g @curviate/cli && curviate --version(需 Node 18+);curviate login --api-key <key> 或设置 CURVIATE_API_KEY;curviate account list --json 获取 --account 的 acc_id。凭据优先级为 flag > 环境变量 > 已存配置。多账号租户下每次写操作都应显式指定 --account,否则可能以错误身份发送。
读取:inbox list(默认 20 条,--unread/--no-unread、--inbox 选 primary/inmail/archived/spam/jobs/starred)、inbox get <chat_id>、inbox messages <chat_id>(--before/--after 为 ISO-8601 UTC)、inbox search、inbox mark-read。列表不会标记已读。inbox get 与 inbox messages 支持 --mode(auto/live/refill/cache_only)与 --max-age;cache_only 未命中返回退出码 14,需改用 refill/auto/live。
发送:message new --to <recipient> "<text>"、message send <chat_id> "<text>"、message get/edit/delete/react/attachment、message inmail(需 --to 与 --subject,消耗 InMail 额度)、message inmail-balance。COMPANY_ 开头的 chat id 以公司主页身份发送,公司收件箱只能回复。发送前务必加 --preview;无幂等键,超时后应先重读线程再决定是否重发。
事件:webhook create/list/events/get/update/delete/verify,--source 为 messaging、user 或 account_status;每次投递都应先用 webhook verify 校验签名。
限制:--limit 仅接受 1-25;inbox list 与 inbox search 不能可靠判断某会话是否存在,必要时用 --cursor 翻页;inbox list 无日期范围参数;近期发送或删除可能延迟数分钟出现在 inbox messages,可用 message get 立即确认;按退出码分支处理,不要按文本判断。