linkedin Skill
通用 LinkedIn 自动化——获取资料、搜索人脉和公司、发送消息、管理人脉、发布帖子等。适用于用户需要操作 LinkedIn 的场景。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
LinkedIn Skill
You have access to linkedin – a CLI tool for LinkedIn automation. Use it to fetch profiles, search people and companies, send messages, manage connections, create posts, react, comment, and more.
Each command sends a request to Linked API, which runs a real cloud browser to perform the action on LinkedIn. Operations are not instant – expect 30 seconds to several minutes depending on complexity.
If linkedin is not available, install it:
npm install -g @linkedapi/linkedin-cli
Authentication
If a command fails with exit code 2 (authentication error), ask the user to set up their account:
- Go to app.linkedapi.io and sign up or log in
- Connect their LinkedIn account
- Copy the Linked API Token and Identification Token from the dashboard
Once the user provides the tokens, run:
linkedin setup --linked-api-token=TOKEN --identification-token=TOKEN
Global Flags
Always use --json and -q for machine-readable output:
LINKEDAPI_CLIENT=skill:linkedin linkedin <command> --json -q
When using this skill, run every linkedin ... example below with the
LINKEDAPI_CLIENT=skill:linkedin prefix so Linked API can attribute usage to the skill.
| Flag | Description |
|------|-------------|
| --json | Structured JSON output |
| --quiet / -q | Suppress stderr progress messages |
| --fields name,url,... | Select specific fields in output |
| --no-color | Disable colors |
| --account "Name" | Use a specific account for this command |
List Flags
Flags described below as comma-separated split their value on every comma. When any value contains a comma itself – a location such as Chicago, Illinois, an industry such as Technology, Information and Internet, a company such as Example Co., Ltd. – pass the whole list as a JSON array instead, or the value is silently split into separate filters. The JSON form needs linkedin-cli 1.2.24 or newer (linkedin --version; update with npm install -g @linkedapi/linkedin-cli):
linkedin person search --term "designer" --locations '["Chicago, Illinois","London, United Kingdom"]' --json -q
Output Format
Success:
{"success": true, "data": {"name": "John Doe", "headline": "Engineer"}}
Error:
{"success": false, "error": {"type": "personNotFound", "message": "Person not found"}}
Exit code 0 means the API call succeeded – always check the success field for the action outcome. Non-zero exit codes indicate infrastructure errors:
| Exit Code | Meaning |
|-----------|---------|
| 0 | Success (check success field – action may have returned an error like "person not found") |
| 1 | General/unexpected error |
| 2 | Missing or invalid tokens |
| 3 | Subscription/plan required |
| 4 | LinkedIn account issue |
| 5 | Invalid arguments |
| 6 | Rate limited |
| 7 | Network error |
| 8 | Workflow timeout (workflowId returned for recovery) |
Commands
Fetch a Person Profile
linkedin person fetch <url> [flags] --json -q
Optional flags to include additional data:
--experience– work history--education– education history--skills– skills list--languages– languages--posts– recent posts (with--posts-limit N,--posts-since TIMESTAMP)--comments– recent comments (with--comments-limit N,--comments-since TIMESTAMP)--reactions– recent reactions (with--reactions-limit N,--reactions-since TIMESTAMP)
Only request additional data when needed – each flag increases execution time.
# Basic profile
linkedin person fetch https://www.linkedin.com/in/username --json -q
# With experience and education
linkedin person fetch https://www.linkedin.com/in/username --experience --education --json -q
# With last 5 posts
linkedin person fetch https://www.linkedin.com/in/username --posts --posts-limit 5 --json -q
Endorse a Person's Skills
linkedin person endorse <url> --skill 'Project Management' --json -q
linkedin person endorse <url> --pattern manage --pattern '^scrum$' --json -q
linkedin person endorse <url> --all --json -q
Choose exactly one of --skill, --pattern or --all:
- Use
--skillfor one exact skill name; letter case and extra spaces are ignored. - Use repeatable
--patternto select skills matching any of the patterns. Patterns use RE2, are case-insensitive and match anywhere in the name. Anchor with^…$to match a whole name. Provide 1-20 patterns, each 1-200 characters; lookaround and backreferences are unsupported. - Use
--allonly when the user wants every skill endorsed. It omits the patterns parameter; never send an empty patterns array.
Skill names are in the profile owner's language, regardless of your own LinkedIn language. Fetch the profile with --skills first when you need to discover the names; a German profile may list Projektmanagement rather than Project Management.
Only 1st-degree connections can receive endorsements. An already-endorsed skill stays endorsed and counts as success. Each successful endorsement, including an existing one, counts toward the account's stEndorsements limit. With --pattern or --all, check every item's success and error.type in data: a failed skill does not stop the others, and limitExceeded can affect only part of the result.
Search People
linkedin person search [flags] --json -q
| Flag | Description |
|------|-------------|
| --term | Search keyword or phrase; required unless --url is given |
| --url | LinkedIn people search URL (linkedin.com/search/results/people/...), such as an anonymous viewer's searchUrl; overrides --term and the filters |
| --limit | Max results |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |
| --connection-degrees | Comma-separated connection degrees: 1st, 2nd, 3rd+ |
linkedin person search --term "product manager" --locations "San Francisco" --json -q
linkedin person search --term "engineer" --current-companies "Google" --limit 20 --json -q
linkedin person search --url "https://www.linkedin.com/search/results/people/?keywords=CTO" --json -q
Fetch a Company
linkedin company fetch <url> [flags] --json -q
Optional flags:
--employees– include employees--dms– include decision makers--posts– include company posts
Employee filters (require --employees):
| Flag | Description |
|------|-------------|
| --employees-limit | Max employees to retrieve |
| --employees-first-name | Filter by first name |
| --employees-last-name | Filter by last name |
| --employees-position | Filter by position |
| --employees-locations | Comma-separated locations |
| --employees-industries | Comma-separated industries |
| --employees-schools | Comma-separated school names |
| --employees-connection-degrees | Comma-separated connection degrees: 1st, 2nd, 3rd+ |
| Flag | Description |
|------|-------------|
| --dms-limit | Max decision makers to retrieve (requires --dms) |
| --posts-limit | Max posts to retrieve (requires --posts) |
| --posts-since | Posts since ISO timestamp (requires --posts) |
# Basic company info
linkedin company fetch https://www.linkedin.com/company/name --json -q
# With employees filtered by position
linkedin company fetch https://www.linkedin.com/company/name --employees --employees-position "Engineer" --json -q
# With decision makers and posts
linkedin company fetch https://www.linkedin.com/company/name --dms --posts --posts-limit 10 --json -q
Search Companies
linkedin company search [flags] --json -q
| Flag | Description |
|------|-------------|
| --term | Search keyword; required unless --url is given |
| --url | LinkedIn companies search URL (linkedin.com/search/results/companies/...); overrides --term and the filters |
| --limit | Max results |
| --sizes | Comma-separated sizes: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
linkedin company search --term "fintech" --sizes "11-50,51-200" --json -q
Send a Message
linkedin message send <person-url> '<text>' --json -q
Text up to 1900 characters. Wrap the message in single quotes to avoid shell interpretation issues.
linkedin message send https://www.linkedin.com/in/username 'Hey, loved your latest post!' --json -q
Inbox
To read messages use inbox get. Call message get only when you need a person's earlier history, and never repeat it to check for new messages.
Enable inbox monitoring once per account, before sending messages whose replies you need – it captures only messages that arrive after it is on:
linkedin inbox sync --json -q # standard inbox
linkedin inbox sync --nv --json -q # Sales Navigator inbox
New messages from everyone, with an advancing --since:
linkedin inbox get --since 2024-01-15T10:30:00Z --json -q
The whole known conversation with one person, including history loaded by message get:
linkedin inbox get --person https://www.linkedin.com/in/username --json -q
With --person, the output has messages and threads. Each thread has historyComplete: if it is false and you need earlier messages, run message get once, then inbox get --person again. A hashed person URL (personHashedUrl from a message) always matches; a public URL matches only once Linked API knows it, so prefer the hashed URL when messages show personPublicUrl: null. Message times are whole minutes: to check for a reply, pass --type of your message and --since a few minutes before it, take the earliest us message in the result (the one you sent, not a later follow-up) and count a them message that is not earlier than it; if your message is not in the result yet, the reply is not known yet.
Get Conversation
linkedin message get <person-url> [--since TIMESTAMP] --json -q
Loads the person's earlier history on the first call, which may take longer; subsequent calls are faster. Prefer linkedin inbox get --person to read messages – use this only when you need history from before inbox monitoring was enabled.
linkedin message get https://www.linkedin.com/in/username --json -q
linkedin message get https://www.linkedin.com/in/username --since 2024-01-15T10:30:00Z --json -q
Connection Management
Check connection status
linkedin connection status <url> --json -q
Send connection request
linkedin connection send <url> [--note 'text'] [--email user@example.com] --json -q
List connections
linkedin connection list [flags] --json -q
| Flag | Description |
|------|-------------|
| --limit | Max connections to return |
| --since | Only connections made since ISO timestamp (only works when no filter flags are used) |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |
linkedin connection list --limit 50 --json -q
linkedin connection list --current-companies "Google" --position "Engineer" --json -q
linkedin connection list --since 2024-01-01T00:00:00Z --json -q
List pending outgoing requests
linkedin connection pending --json -q
List incoming connection requests
Invitations that others have sent to you (received requests).
linkedin connection requests --json -q
Accept an incoming request
linkedin connection accept <url> --json -q
Ignore an incoming request
linkedin connection ignore <url> --json -q
Withdraw a pending request
linkedin connection withdraw <url> [--no-unfollow] --json -q
By default, withdrawing also unfollows the person. Use --no-unfollow to keep following.
Remove a connection
linkedin connection remove <url> --json -q
Posts
Fetch a post
linkedin post fetch <url> [flags] --json -q
| Flag | Description |
|------|-------------|
| --comments | Include comments |
| --reactions | Include reactions |
| --comments-limit | Max comments to retrieve (requires --comments) |
| --comments-sort | Sort order: mostRelevant or mostRecent (requires --comments) |
| --comments-replies | Include replies to comments (requires --comments) |
| --reactions-limit | Max reactions to retrieve (requires --reactions) |
linkedin post fetch https://www.linkedin.com/posts/username_activity-123 --json -q
# With comments sorted by most recent, including replies
linkedin post fetch https://www.linkedin.com/posts/username_activity-123 \
--comments --comments-sort mostRecent --comments-replies --json -q
Search posts
linkedin post search [flags] --json -q
| Flag | Description |
|------|-------------|
| --term | Search keyword or phrase, up to 50 characters |
| --limit | Max results to return, up to 100 |
| --from-members | People whose posts to keep |
| --from-companies | Companies whose posts to keep |
| --mentioning-members | People the post must mention |
| --mentioning-companies | Companies the post must mention |
| --author-companies | Companies the author works at |
Each actor flag is a comma-separated list. An element is name or name:identifier, where the identifier is a URN or LinkedIn URL of that person or company and pins the filter to exactly them. A name alone may match a namesake. When an entry cannot be applied, the action fails with filterNotApplied; correct or remove it rather than retrying.
linkedin post search --term "ai" --from-members "Bill Gates,Example Person:urn:li:member:123456789" --json -q
Create a post
linkedin post create '<text>' [flags] --json -q
| Flag | Description |
|------|-------------|
| --company-url | Post on behalf of a company page (requires admin access) |
| --attachments | Attachment as url:type or url:type:name. Types: image, video, document. Can be specified multiple times. |
| --mention | One mention, bound to @[key] in the text. Format below. Can be specified multiple times, up to 20. |
Attachment limits: up to 9 images, or 1 video, or 1 document. Cannot mix types.
Mention format — write @[key] in the text, then describe that key with --mention as key:name or key:name:identifier. Everything after the second : is the identifier, so its own colons need no escaping. The identifier is optional and is one of urn:li:member:, urn:li:organization:, a hashed profile URL, or a hashed company URL; without it LinkedIn's first suggestion for name is used, which may not be the entity you meant. Every @[key] must have a matching --mention and vice versa, and keys cannot repeat.
linkedin post create 'Excited to share our latest update!' --json -q
# With a document
linkedin post create 'Our Q4 report' \
--attachments "https://example.com/report.pdf:document:Q4 Report" --json -q
# Mentioning a person
linkedin post create 'Huge thanks to @[author] for the write-up!' \
--mention "author:Example Person:urn:li:member:123456789" --json -q
# Post as a company
linkedin post create 'Company announcement' \
--company-url https://www.linkedin.com/company/name --json -q
Repost a post
linkedin post repost <url> [flags] --json -q
| Flag | Description |
|------|-------------|
| --text | Your own commentary (up to 3000 characters). Without it the post is reposted as is. |
| --mention | One mention, bound to @[key] in --text. Same format as for post create. Can be specified multiple times, up to 20. |
The repost's own postUrl and postUrn come back, not those of the post you reposted. They are empty when the repost was published but LinkedIn did not return its address — do not retry, the repost is already live.
alreadyReposted is returned only when LinkedIn refuses an instant repost (one without --text). LinkedIn does not always refuse a repeat repost: a repost of your own post, or a repost with commentary, can be published again. Keep track of what you have already reposted instead of relying on this error.
linkedin post repost https://www.linkedin.com/posts/username_activity-123 --json -q
# With commentary
linkedin post repost urn:li:activity:1234567890123456789 \
--text 'Worth reading, especially the part on onboarding.' --json -q
React to a post
linkedin post react <url> --type <reaction> [--company-url <url>] --json -q
Reaction types: like, love, support, celebrate, insightful, funny.
linkedin post react https://www.linkedin.com/posts/username_activity-123 --type like --json -q
# React on behalf of a company
linkedin post react https://www.linkedin.com/posts/username_activity-123 --type celebrate \
--company-url https://www.linkedin.com/company/name --json -q
Comment on a post
linkedin post comment <url> '<text>' [--company-url <url>] --json -q
Text up to 1000 characters.
linkedin post comment https://www.linkedin.com/posts/username_activity-123 'Great insights!' --json -q
# Comment on behalf of a company
linkedin post comment https://www.linkedin.com/posts/username_activity-123 'Well said!' \
--company-url https://www.linkedin.com/company/name --json -q
Statistics
# Social Selling Index
linkedin stats ssi --json -q
# Performance analytics (profile views, post impressions, search appearances)
linkedin stats performance --json -q
# API usage for a date range
linkedin stats usage --start 2024-01-01T00:00:00Z --end 2024-01-31T00:00:00Z --json -q
# Who viewed your profile
linkedin stats viewers --limit 50 --json -q
# Only views since a moment
linkedin stats viewers --since 2026-08-01T00:00:00Z --json -q
Each viewer is either identified — carrying name, publicUrl and urn (a member URN, null
when LinkedIn does not expose it) — or anonymous, carrying only the description LinkedIn showed
and a searchUrl you can pass to linkedin person search --url (linkedin-cli 1.2.24 or newer) to look for them. Viewers come
newest first, and viewedAt is an estimate derived from the relative age LinkedIn displays.
Sales Navigator
Requires a LinkedIn Sales Navigator subscription. Person and company lookups accept public or hashed LinkedIn URLs.
Fetch person
linkedin navigator person fetch <url> --json -q
Search people
linkedin navigator person search [flags] --json -q
| Flag | Description |
|------|-------------|
| --term | Search keyword or phrase; required unless --url is given |
| --url | Sales Navigator people search URL (linkedin.com/sales/search/people/...); overrides --term and the filters |
| --limit | Max results |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |
| --years-of-experience | Comma-separated ranges: lessThanOne, oneToTwo, threeToFive, sixToTen, moreThanTen |
| --connection-degrees | Comma-separated connection degrees: 1st, 2nd, 3rd+, groupMembers |
linkedin navigator person search --term "VP Marketing" --locations "United States" --json -q
linkedin navigator person search --term "CEO" --years-of-experience "moreThanTen" --json -q
Fetch company
linkedin navigator company fetch <url> [flags] --json -q
Optional flags:
--employees– include employees--dms– include decision makers
Employee filters (require --employees):
| Flag | Description |
|------|-------------|
| --employees-limit | Max employees to retrieve |
| --employees-first-name | Filter by first name |
| --employees-last-name | Filter by last name |
| --employees-positions | Comma-separated positions |
| --employees-locations | Comma-separated locations |
| --employees-industries | Comma-separated industries |
| --employees-schools | Comma-separated school names |
| --employees-years-of-experience | Comma-separated experience ranges |
| --employees-connection-degrees | Comma-separated connection degrees: 1st, 2nd, 3rd+, groupMembers |
| --dms-limit | Max decision makers to retrieve (requires --dms) |
linkedin navigator company fetch https://www.linkedin.com/sales/company/97ural --employees --dms --json -q
linkedin navigator company fetch https://www.linkedin.com/sales/company/97ural \
--employees --employees-positions "Engineer,Designer" --employees-locations "Europe" --json -q
Search companies
linkedin navigator company search [flags] --json -q
| Flag | Description |
|------|-------------|
| --term | Search keyword; required unless --url is given |
| --url | Sales Navigator companies search URL (linkedin.com/sales/search/company/...); overrides --term and the filters |
| --limit | Max results |
| --sizes | Comma-separated sizes: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --revenue-min | Min annual revenue in M USD: 0, 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000 |
| --revenue-max | Max annual revenue in M USD: 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1000+ |
linkedin navigator company search --term "fintech" --sizes "11-50,51-200" --json -q
linkedin navigator company search --term "logistics" --revenue-min 10 --revenue-max 100 --locations "United States" --json -q
Send InMail
linkedin navigator message send <person-url> '<text>' --subject '<subject>' --json -q
Text up to 1900 characters. Subject up to 80 characters.
linkedin navigator message send https://www.linkedin.com/in/username \
'Would love to chat about API integrations' --subject 'Partnership Opportunity' --json -q
Get Sales Navigator conversation
linkedin navigator message get <person-url> [--since TIMESTAMP] --json -q
Prefer linkedin inbox get --person --type nv to read Sales Navigator messages; use this only when you need the person's earlier history.
Sales Navigator saved leads, accounts, lists and searches
These commands need linkedin-cli 1.2.26 or newer (linkedin --version; update with npm install -g @linkedapi/linkedin-cli).
Plus plan required. IDs are strings.
linkedin navigator alerts --limit 50 --sort latest --json -q
linkedin navigator alerts --list-id <list-id> --json -q
linkedin navigator alerts --subject '<hashed-url-or-subject-urn>' --subject '<another-identity>' --json -q
linkedin navigator person save <url> [--list-id <list-id>] --json -q
linkedin navigator person unsave <url> --json -q
linkedin navigator company save <url> [--list-id <list-id>] --json -q
linkedin navigator company unsave <url> --json -q
linkedin navigator lists --type <lead|account> --json -q
linkedin navigator lists create --type <lead|account> --name 'Prospects' [--description 'Notes'] --json -q
linkedin navigator lists delete <list-id> --json -q
linkedin navigator lists leads <list-id> [--limit 25] --json -q
linkedin navigator lists accounts <list-id> [--limit 25] --json -q
linkedin navigator person remove-from-list <url> --list-id <list-id> --json -q
linkedin navigator company remove-from-list <url> --list-id <list-id> --json -q
linkedin navigator lists rename <list-id> --name 'New name' --json -q
linkedin navigator saved-searches --type <lead|account> --json -q
linkedin navigator saved-searches create '<search-url>' --type <lead|account> [--name 'Heads of Sales'] --json -q
linkedin navigator saved-searches delete <saved-search-id> --json -q
Alerts also accept --category lead|account, --types (comma-separated or a JSON array), --since (inclusive ISO timestamp), and --exclude-suggested. --subject is repeatable: each occurrence is exactly one recognised hashed LinkedIn URL or Sales Navigator subject URN. These identities can contain commas, so never split them or pass a JSON array. An empty subject list is unrestricted. Subjects are ORed; the other filters are ANDed. Public URL handles cannot identify subjects for this filter. --list-id requires --sort latest.
List-member limits are 1–1000 (default 25). Removing membership keeps the subject saved and in other lists; removing an absent membership succeeds. Unsave removes the saved state and all memberships. Deleting a list keeps its members saved. Rename trims its name (1–75 characters, no line breaks), returns listAlreadyExists for a duplicate and listNotRenamable for system lists. Saved searches require a copied /sales/search/people (lead) or /sales/search/company (account) URL matching --type; --name (trimmed, 1–256 characters, one line) renames the new search; without it Sales Navigator names it, e.g. by its keywords. A name already used by a saved search of the same type returns savedSearchAlreadyExists, a full catalog savedSearchLimitReached; savedSearchRenameUnconfirmed means the search was saved under Sales Navigator's name and kept. Deleted or foreign IDs return savedSearchNotFound.
Custom Workflows
Execute a custom workflow definition from a file, stdin, or inline:
# From file
linkedin workflow run --file workflow.json --json -q
# From stdin
cat workflow.json | linkedin workflow run --json -q
# Inline
echo '{"actions":[...]}' | linkedin workflow run --json -q
Check workflow status or wait for completion:
linkedin workflow status <id> --json -q
linkedin workflow status <id> --wait --json -q
See Building Workflows for the workflow JSON schema.
Changelog
Read what is new in Linked API. Check it before telling the user that something is not supported yet – the capability may have shipped recently. No authentication is needed:
linkedin changelog --json -q # Every release, newest first
linkedin changelog --since 2026-10-01 --json -q # Releases from that week on
The JSON is the changelog itself, not the usual success/data envelope: entries holds releases, each with a date (the Monday of its week) and items with title, body and docs (a path on https://linkedapi.io). A release counts as shipped at the end of its week, so --since in the middle of a week still returns that week's release – deduplicate by date. A malformed --since exits with code 5 and the server's message.
Account Management
linkedin account list # List accounts (* = active)
linkedin account switch "Name" # Switch active account
linkedin account rename "Name" --name "New Name" # Rename account
linkedin reset # Remove active account
linkedin reset --all # Remove all accounts
Important Behavior
- Sequential execution. All operations for an account run one at a time. Multiple requests queue up.
- Not instant. A real browser navigates LinkedIn – expect 30 seconds to several minutes per operation.
- Timestamps in UTC. All dates and times are in UTC.
- Single quotes for text arguments. Use single quotes around message text, post text, and comments to avoid shell interpretation issues with special characters.
- Action limits. Per-account limits are configurable on the platform. A
limitExceedederror means the limit was reached. - URL normalization. All LinkedIn URLs in responses are normalized to
https://www.linkedin.com/...format without trailing slashes. - Null fields. Fields that are unavailable are returned as
nullor[], not omitted.