前言¶
做 B2B 线索、招聘情报或竞品公司画像时，往往需要查 LinkedIn 上的人员履历、公司雇员、在招岗位与动态内容。手工在网页里翻页、复制字段，很难和 Agent 的对话式任务衔接；自己写爬虫又容易踩平台规则与维护成本。
下面介绍社区 Skill keyapi-linkedin（v1.1.2）：它把自然语言需求映射到 KeyAPI 的 REST 接口，并以 KeyAPI 官方文档 为契约来源，由 Agent 按场景查文档、鉴权、发请求，再整理成分析结论。Skill 标注 requires_api_key=true，调用前需要本地配置 KeyAPI Bearer Token。
这是什么¶
keyapi-linkedin 是 SkillHub 社区发布的 Agent Skill（坐标 @user_2e47cd26/keyapi-linkedin-ca，分类 data-analysis）。发布者为 user_2e47cd26，当前版本 1.1.2。
一句话定位：通过 KeyAPI REST API 分析 LinkedIn 用户与公司数据，并在每次调用前对照实时官方文档确认路径与参数，而不是用网页浏览替代 API 结果。
核心功能¶
以下能力均来自 Skill 简介与内置 SKILL.md、references/scenarios.md，对应 KeyAPI 的 /v1/linkedin/... 类端点（具体 method、path、参数以文档检索结果为准）。
人员侧
- 职业档案：简介、联系方式、工作经历、教育、技能
- 背书与成果：出版物、认证、荣誉、推荐
- 兴趣与社交：兴趣、关注/连接相关信号
- 内容与互动：帖子、评论、视频等用户发布内容
- 人员搜索与档案详情（场景卡片中的 people search、profile detail 等）
公司侧
- 公司档案、员工列表、公司发布的帖子
- 与公司相关的招聘规模信号（如 job count，与岗位场景配合）
岗位侧
- 职位列表、职位数量、职位详情
执行方式上的约束（Skill 硬性约定）
- 文档真源：
https://docs.keyapi.ai/llms.txt及链接到的端点页；若与 Skill 内文字冲突，以官方文档为准。 - 成功判定：检查 HTTP 状态与 KeyAPI 响应信封，
code = 0表示成功，非零为 API 级失败。 - 不得将
KEYAPI_TOKEN打印或回显到对话中；凭证仅保存在本地环境变量。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装说明执行完整安装（示例为官方文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 keyapi-linkedin¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。官方页面给出的安装提示为：参照 https://skillhub.cn/install/skillhub.md，安装坐标 @user_2e47cd26/keyapi-linkedin-ca。
命令形式如下（将 <skills 目录> 换成你使用的客户端路径）：
skillhub install @user_2e47cd26/keyapi-linkedin-ca --dir <skills 目录>
常见客户端 skills 路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 被加载。
配置 KeyAPI 鉴权¶
API 基址为 https://api.keyapi.ai，请求头为 Authorization: Bearer $KEYAPI_TOKEN。Token 可在 KeyAPI Dashboard 获取；鉴权说明见 Bearer Authentication。
在 Skill 目录下（与 SKILL.md 同级），推荐用自带脚本配置与检查状态：
node scripts/configure-keyapi-auth.mjs --status
若 authStatus 为 unavailable，执行交互式配置：
node scripts/configure-keyapi-auth.mjs
也可在非交互环境中传入 token（勿将 token 提交到仓库或贴在公开场合）：
node scripts/configure-keyapi-auth.mjs --token "your_keyapi_token"
POSIX 环境亦可手动导出：
export KEYAPI_TOKEN=your_keyapi_token
仅当 --status 报告 authStatus: "available" 后，再继续 live API 调用。
典型用法¶
Skill 约定的工作流可以概括为：确认鉴权 → 用场景卡片理解用户目标 → 检索当前文档 → 用 helper 脚本发 REST 请求 → 用业务语言汇报结果。helper 脚本需在该 Skill 目录下执行（或相对于 SKILL.md 解析 scripts/ 路径）。
1. 解析当前端点文档（发请求前）
用语义查询拉取与任务匹配的文档页，避免凭记忆拼路径：
node scripts/search-keyapi-docs.mjs --query "search people" --resolve
2. 调用已文档化的 GET 端点
路径占位符需替换为 --resolve 或文档页中的实际 /v1/linkedin/...：
node scripts/keyapi-api.mjs --path /v1/linkedin/... --query-param example=value
3. 需要完整 JSON 做汇总时
大响应可写入文件，完整业务数据在 data.data 中读取：
node scripts/keyapi-api.mjs --path /v1/linkedin/... --query-param example=value --output-file response.json
4. POST 与较大请求体
node scripts/keyapi-api.mjs --path /v1/linkedin/... --method POST --body-file request.json
场景如何选
references/scenarios.md 将常见意图归纳为若干卡片，例如：人员搜索与档案基线、履历与技能深挖、用户内容动态、公司画像与雇员、岗位与招聘需求等。Agent 应先对齐「目标、实体、范围、排序/指标、分页深度、输出格式」，再加载对应的 linkedin-user-rules.md、linkedin-company-rules.md 或 linkedin-jobs-rules.md，并按文档 shortlist 中的端点页（如 Search people、Get user profile、Get company profile、职位相关端点）确认参数后再调用。
用户只需用自然语言描述任务即可，例如「按关键词搜一批候选人并拉联系方式」「给某公司做雇员与在招岗位简报」；Skill 会要求 Agent 先选场景、补全少量关键输入，而不是一开始罗列全部 API。
适用场景与注意¶
适合谁
- 需要在 Agent 对话里完成 LinkedIn 结构化调研的数据分析、销售运营、招聘与研究岗位
- 已愿意使用 KeyAPI 按量/按账户付费，并接受 REST 接口与官方文档驱动的集成方式
- 希望输出区分「API 返回事实」与「推断」，并支持表格、简报或 JSON 导出
限制与注意
- 必须自备 KeyAPI Token；无凭证时 Skill 要求暂停 live 调用并引导运行
configure-keyapi-auth.mjs，而不是改用爬网页凑数据。 - 端点与字段以实时文档为准；场景卡片只做路由提示，不能替代
search-keyapi-docs.mjs --resolve或打开llms.txt。 - 合规与授权：LinkedIn 与 KeyAPI 各自的服务条款、数据使用范围需由使用方自行遵守；本文不讨论具体合规结论。
- 费用与配额：每次 live 请求都会真实调用 KeyAPI；重复相同命令会重复计费，Skill 明确 helper 不做本地缓存去重。
- SkillHub 页面上该 Skill 评分为 100000，下载 567 次、安装 2 次（统计来自 SkillHub 抓取资料，会随时间变化）。
结尾¶
keyapi-linkedin 把「查 LinkedIn 专业数据」收敛成一条可重复的 Agent 工作流：场景路由、文档校验、脚本化 REST、分析化输出。若你已在用 Cursor、Claude Code 或 Codex 类客户端，可按上文安装到对应 skills 目录，配置 KEYAPI_TOKEN 后即可在对话里发起调研任务。
- SkillHub 页面：https://www.skillhub.cn/skills/user_2e47cd26/keyapi-linkedin-ca
- 安装坐标入口：https://api.skillhub.cn/user_2e47cd26/keyapi-linkedin-ca
