/int-linkedin

name: int-linkedin
description: "Query LinkedIn API — profile info, posts (when approved), org stats. Supports multi-account via OAuth. Use when user asks about LinkedIn metrics, LinkedIn profile, LinkedIn posts, or any reference to LinkedIn analytics."

LinkedIn API

LinkedIn integration to monitor user profile and (future) Company Page. Multi-account via OAuth (Social Auth App).

Setup

Accounts configured via `make social-auth`. Saved in `.env`:

SOCIAL_LINKEDIN_1_LABEL=Your Name
SOCIAL_LINKEDIN_1_ACCESS_TOKEN=YOUR_TOKEN
SOCIAL_LINKEDIN_1_PERSON_URN=urn:li:person:YOUR_URN

API Client

python3 {project-root}/.claude/skills/int-linkedin/scripts/linkedin_client.py <command> [args]

Commands

linkedin_client.py accounts                    # List accounts
linkedin_client.py profile [account]           # Profile (name, email, photo)
linkedin_client.py my_posts [account] [N]      # Recent posts (requires scope w_member_social)
linkedin_client.py post_stats POST_URN         # Reactions/comments of a post
linkedin_client.py org_followers [account]     # Org followers (requires Advertising API)
linkedin_client.py summary                     # Summary of all accounts

Available scopes

| Scope | Status | LinkedIn Product | |-------|--------|-----------------| | `openid profile email` | Active | Sign In with OpenID Connect | | `w_member_social` | Active | Share on LinkedIn | | `r_organization_social` | Pending | Advertising API (request form) | | `r_organization_admin` | Pending | Advertising API (request form) |

Current limitations

• **Posts:** Reading posts requires an additional scope not available in the current tier
• **Company Page:** Requires Advertising API (pending approval)
• **Workaround:** Export CSV from LinkedIn Analytics for Company Page data

Note on versioned API

• Base URL: `https://api.linkedin.com/rest/` (org/analytics endpoints)
• Required headers: `Linkedin-Version: 202603`, `X-Restli-Protocol-Version: 2.0.0`
• Personal profile uses `/v2/userinfo` (OpenID Connect)