Skip to content
Skills Library
Programming · Tool integration

linkedin-api-setup

/linkedin-api-setup

Guided, step-by-step setup to connect Claude to LinkedIn's official API - create a LinkedIn Page and developer app, add the right products, get the client ID and secret (the "API key"), sign in with OAuth, and make a first safe test post. Use when someone says "set up LinkedIn automation", "get a LinkedIn API key", "connect Claude to LinkedIn", "authorize LinkedIn", or hits an OAuth error.

Licence
MIT
Last repository change
28.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Guided, step-by-step setup to connect Claude to LinkedIn's official API - create a LinkedIn Page and developer app, add the right products, get the client ID and secret (the "API key"), sign in with OAuth, and make a first safe test post. Use when someone says "set up LinkedIn automation", "get a LinkedIn API key", "connect Claude to LinkedIn", "authorize LinkedIn", or hits an OAuth error.

Triggers from the description

API keyset up LinkedIn automationget a LinkedIn API keyconnect Claude to LinkedInauthorize LinkedIn
Original author description

Guided, step-by-step setup to connect Claude to LinkedIn's official API - create a LinkedIn Page and developer app, add the right products, get the client ID and secret (the "API key"), sign in with OAuth, and make a first safe test post. Use when someone says "set up LinkedIn automation", "get a LinkedIn API key", "connect Claude to LinkedIn", "authorize LinkedIn", or hits an OAuth error.

How it works

  1. Rules for you (Claude) while running this
  2. Step 0 - choose the path
  3. Step 1 - install the toolkit
  4. Step 2 - a LinkedIn Page (required to create an app)
  5. Step 3 - create the developer app
  6. Step 4 - add the products
  7. Step 5 - redirect URL and credentials
  8. Step 6 - sign in
  9. Step 7 - dry run
  10. Step 8 - one real test post (optional, needs the user's explicit yes)
Original SKILL.md headings · 81 lines, 812 words
SKILL.md preview
---
name: linkedin-api-setup
description: Guided, step-by-step setup to connect Claude to LinkedIn's official API - create a LinkedIn Page and developer app, add the right products, get the client ID and secret (the "API key"), sign in with OAuth, and make a first safe test post. Use when someone says "set up LinkedIn automation", "get a LinkedIn API key", "connect Claude to LinkedIn", "authorize LinkedIn", or hits an OAuth error.
---

# LinkedIn API setup wizard

Goal: from nothing to "Claude can draft, and after my approval publish, to my LinkedIn" in about 15 minutes, using only LinkedIn's official API.

## Rules for you (Claude) while running this
- **Never ask the user to paste the client secret, a token or a password into the chat.** Tell them to run `li-auth setup` in their own terminal (the secret is typed hidden and saved to a private file).
- Do one step at a time. After each step ask them to confirm (or paste an error) before the next.
- Explain plainly: "API key" in LinkedIn language = *Client ID + Client Secret* of a developer app.
- If a step fails, open `linkedin-api/references/08-troubleshooting.md` and use the matching row.
- Do not publish anything real during setup except the optional test post in step 8, and only with their yes.

## Step 0 - choose the path
| You want | Path | Review needed? |
|---|---|---|
| Post to your own profile from Claude | **A: personal posting** | No, instant |
| Also read views, comments, reposts of your posts | **B: add analytics** (second app, Community Management API) | Yes (days to weeks), must be a registered organization |
| Post as a Company Page | **B** too (`w_organization_social` + you must be a Page admin) | Yes |
Start with A. B can be added later.

## Step 1 - install the toolkit
```bash
pipx install git+https://github.com/phoenixDatasolutions/Linkedin-Automation   # or: pip install --user git+https://...
li-auth check          # shows what is missing; nothing secret is printed
```
Requires Python 3.9+. No other packages are installed.

## Step 2 - a LinkedIn Page (required to create an app)
LinkedIn only lets a developer app be linked to a Company Page. If you have none: LinkedIn -> Work -> Create a Company Page (a small "company" or "solo business" page is fine; use your real business or a page you own).

## Step 3 - create the developer app
1. Open https://www.linkedin.com/developers/apps/new and sign in.
2. App name (anything), LinkedIn Page = your page, privacy policy URL (if asked, your website's), logo (any square image).
3. Create the app. Then on the app's **Settings** tab click **Verify** next to the Page and have a Page super admin approve (you, if you made the Page).

## Step 4 - add the products
App -> **Products** tab -> request:
- **Share on LinkedIn** (gives `w_member_social`, instant)
- **Sign in with LinkedIn using OpenID Connect** (gives `openid`, `profile`, `email`, instant)
Open the **Auth** tab and check these scopes are listed. If not, the product was not added.

## Step 5 - redirect URL and credentials
1. Auth tab -> **Authorized redirect URLs for your app** -> add `http://localhost:8765/callback` and save. (If LinkedIn refuses `http`, add `https://oauth.pstmn.io/v1/callback` instead and use `--redirect https://oauth.pstmn.io/v1/callback --manual` in step 6.)
2. Still on the Auth tab, find **Client ID** and **Primary Client Secret** (click the eye icon).
3. In **your own terminal** run `li-auth setup` and paste them when asked. The secret is hidden. They are saved to `~/.config/linkedin-automation/.env` (owner-only). Never into a repository, never into chat.

## Step 6 - sign in
```bash
li-auth login
```
A browser tab opens, approve access. The terminal prints "Signed in as urn:li:person:...". The token lasts about 60 days; `li-auth status` shows the days left. Re-run `li-auth login` when it expires.
Common errors: `unauthorized_scope_error` = the product from step 4 is missing; "redirect_uri doesn't match" = the URL differs by even one character from step 5.

## Step 7 - dry run
```bash
li-post text "Testing my new LinkedIn automation."
```
Nothing is sent. It checks the text and prints exactly what would be published.

## Step 8 - one real test post (optional, needs the user's explicit yes)
```bash
li-post text "Testing my new LinkedIn automation." --visibility CONNECTIONS --publish
```
They must type the word `publish`. Check LinkedIn, then delete it: `li-post delete <urn> --publish`. (The URN is printed after publishing.)

## Step 9 (path B) - analytics app
1. Create a **second** app (steps 2-3). Community Management must be the only product on its app.
2. Products tab -> **Community Management API** -> request Development tier. LinkedIn asks for a business email, your registered organization, website and a use case; a Page super admin must verify the app.
3. When approved, the Auth tab shows `r_member_postAnalytics` (and others).
4. Use a separate credentials folder so the two apps never mix:
```bash
export LINKEDIN_AUTOMATION_HOME=~/.config/linkedin-automation-stats
li-auth setup
li-auth login --scopes "openid profile r_member_postAnalytics r_member_profileAnalytics"
li-stats budget
```
5. Mark your calendar: Development tier access is **removed after 12 months** unless you apply for Standard.

## You are done when
`li-auth status` shows days left, `li-post text "..."` shows a clean dry run, and (optionally) a test post appeared and was deleted. Next: `linkedin-writer`, then `linkedin-publisher`.

Versions

The database has no other skills named linkedin-api-setup.

Database snapshot: 13.11.2026 · package version 09855a350916 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90linkedin-api
    Expert reference for the official LinkedIn API (docs snapshot 2026-10-29, API version 202610). Use for any question about LinkedIn OAuth and tokens, getting API access or an "API key", posting to LinkedIn programmatically (Posts API, images, documents, polls, comments,…
  • 100oauth-client-setup
    Configure oauth client setup operations. Auto-activating skill for API Integration. Triggers on: oauth client setup, oauth client setup Part of the API Integration skill category. Use when working with oauth client setup functionality. Trigger with phrases like "oauth client…
  • 100oauth-compass
    Guides a user through setting up Google, GitHub, LinkedIn or Amazon Cognito OAuth credentials locally with the oauth-compass CLI, without handling their secrets. Use when the user wants to add Google, GitHub, LinkedIn or AWS Cognito sign-in, create an OAuth client or OAuth App,…
  • 100linkedin-api
    Use when wiring an app to LinkedIn's organic Posts / Community Management API — 3-legged OAuth, publishing text, article or document posts to a member profile or company page, and pulling impressions, engagement and follower stats into a durable feedback record. NOT writing the…
  • 100oauth-setup
    Connect an OAuth 2.0 service (Gmail, Google APIs, etc.) using the built-in oauth_authorize tool — get a click-to-authorize link, auto-capture the code, and seal the tokens. Use whenever the operator asks to connect Gmail / a Google API / any OAuth account.
  • 100apple-oauth-setup
    Set up Apple Sign In for Web on Apple Developer Portal via Safari + AppleScript. Use when user says "Apple Sign In", "Apple OAuth", "設定 Apple 登入", "建立 Services ID", "generate .p8 key", "Apple client secret", "developer.apple.com 設定", or needs to configure Apple OAuth for…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.