LinkedIn API 参考文档
LinkedIn API 用一个密钥覆盖 LinkedIn 的全部功能 — Classic、Recruiter、Sales Navigator、公司页、职位、私信以及 Magic Route。下面的每个操作都已在 /linkedin DSN 上线。
概览 #
本参考文档涵盖 LinkedIn，它是 Top-Rated Team API 的一部分。同一个密钥还可以访问消息渠道 API：一个覆盖 WhatsApp、Telegram、邮件、SMS、LINE、TikTok、Instagram、Facebook Messenger 和网站聊天的共享收件箱，以及您自己的 X 账号。密钥和已连接的账号都在控制台中管理；要添加账号，请前往控制台。
通过 AI 使用 #
下面的每个操作，也都以工具的形式提供给任何支持 MCP 的 AI 助手，只需一个地址：
https://top-rated.team/linkedin/mcp/<your API key>在助手要求填写 MCP 服务器地址的地方粘贴它即可。无需安装任何东西：地址中的密钥就是一个普通的 API 密钥，工具由下方的目录生成，它发出的每次调用都要经过与您自己的请求相同的密钥检查、方案检查和账号归属检查。吊销该密钥，连接即告终止。在控制台创建一个 — 见“连接您的 AI”。
这个地址包含您的密钥，所以请像对待密码一样对待它：任何拿到它的人都能通过它使用您的账号。一旦泄露，请吊销那个密钥，再创建一个。
逐个客户端连接
下面每个客户端都只需要那一个地址。这些就是创建密钥后控制台给出的步骤，对任何一个 agent 都一样。
没有登录步骤。您的密钥已经包含在那个地址里，所以当助手问您如何认证时，请选择表示“无”的那个选项 — 它通常叫 No sign in、No authentication 或 None。不要设置 OAuth 客户端，也不要添加请求头。几乎所有人都卡在这一个问题上。
ChatGPT
打开 Settings，找到 Connectors — 取决于您阅读本文的时间，它可能叫 Apps & Connectors 或 Plugins — 然后找到添加 custom（自定义）连接器或 MCP 服务器的选项。在某些方案上，它位于同一区域的 Developer mode 开关之后。把地址粘贴为服务器 URL，选择无需认证的选项，并接受它显示的关于连接第三方服务器的警告。
这里刻意写得笼统：OpenAI 已经不止一次挪动这项设置，而且并非每个方案都提供，所以在这里写出确切的点击路径，不出一个月就会过时。如果您完全找不到它，说明您的账号没有这项功能 — 请改用 Claude，或者从自己的代码里调用 API。他们当前的说明页面是 help.openai.com。
Claude
- 打开 Settings → Customize → Connectors。
- 点击 + Add，然后点击 Add custom connector。
- 给它起一个您认得出的名字 — 用 Top-Rated Team 就行 — 把上面的地址粘贴为 remote MCP server URL，然后按 Continue。
- 在认证步骤选择 No sign in，并让 Request headers 保持为空。按 Add。
- 回到对话中，按左下角的 +，选择 Connectors，然后把它打开。
在 Team 或 Enterprise 方案上，由所有者在 Organization settings → Connectors 下添加一次，其他人再从各自的 Connectors 列表中打开它。Anthropic 官方的说明在 support.claude.com，如果本页与那一页说法不一致，请以那一页为准。
Cursor
打开 Cursor 的设置，找到 MCP — 取决于版本，它曾位于 Tools、Integrations 或 Features 之下。添加一个服务器，给它起个名字，并把地址粘贴为它的 url；请求头和认证都留空。Cursor 把它保存在 ~/.cursor/mcp.json 中，您也可以改为自己在那里手写：一个 mcpServers 条目，唯一的字段就是 url。
放在项目自己的 .cursor/mcp.json 里的服务器，需要先在同一个设置页面中打开一次，智能体才会使用它。放在您主目录文件里的则在所有地方都已启用。
VS Code
VS Code 通过 GitHub Copilot 的代理模式连接 MCP 服务器，所以要先打开 Copilot。下面的按钮把地址交给 VS Code，它会在添加前询问一次。手动的话是在命令面板里选 MCP: Add Server，然后 HTTP，然后填地址。
这个按钮打开的是 VS Code Stable。Insiders 用 vscode-insiders: 接收同一个地址，命令面板那条路在两者上都管用 — 终端里的 code --add-mcp 也一样。
Grok
打开 grok.com/connectors，点击 New connector，选择 Custom。把地址粘贴为 MCP 服务器 URL，并选择无需认证的选项。在 Business 或 Enterprise 账号上，先由管理员为组织添加该连接器，然后每个人再各自把它打开。
这是 xAI 的助手通过 MCP 读取您的账号。它与 X API 不是一回事：X API 直接在 X 上发帖和读取，并有自己的密钥 — 如果您想要的是那个，请改为连接 X 渠道。
Gemini
打开 gemini.google.com/apps — 即 Connected apps 页面 — 并选择 Add a custom app。把上面的地址粘贴为 MCP server URL，点击 Next 并允许。它是在网页版里添加的，添加之后在 Gemini 手机应用里也能用。
Google 只给部分 Google 账号提供自定义应用 — 截至撰写本文时，条件是个人账号、英语，并且用网页版而不是手机 — 所以如果该页面上没有 Add a custom app，说明您的账号暂时还没有这项功能。Google 自己的页面是 support.google.com，如果本页与那一页的说法不一致，以那一页为准。Gemini 会让您确认任何会写入内容的操作。
Claude Code
在终端里运行 claude mcp add --transport http top-rated，后面用引号附上上面的地址。加上 -s user，就能让它在每个项目里都可用，而不只是当前这一个。此后无论您在哪里运行 Claude Code — 终端、桌面应用，还是它所接入的编辑器 — 都能用到它，/mcp 会列出它能做的事。无需登录：密钥已经包含在地址里了。
Codex
在终端里运行 codex mcp add top-rated --url，后面用引号附上上面的地址。手动配置的话，就是在 ~/.codex/config.toml 中写一个 [mcp_servers.top-rated] 块，其中有一行 url。不要在同一个块里再写 command 行：Codex 会拒绝同时用两种方式描述的服务器。
较早的 Codex 只有在该文件顶部写了 experimental_use_rmcp_client = true 时，才会读取 url。请先更新 Codex，只有更新后地址仍被忽略时，再添加那一行。
其他助手
任何通过 HTTP 支持 MCP 的助手，都只需要这同一个地址，别的都不需要。没有要安装的软件包，也没有要编辑的配置文件。如果它问传输方式，那就是通过 HTTP 的远程服务器，而不是要运行的命令。
检查是否成功。问助手“列出我已连接的 LinkedIn 账号”。如果它用您的账号列表回答，一切就都接通了。如果它说没有这样的工具，那就是粘贴的地址缺了密钥部分，或者连接器已添加但没有在那个对话中打开。
端点目录 #
LinkedIn API 上的每个操作，按领域分组。打开一张卡片，即可查看它的参数、请求和响应。