@rmdes/indiekit-syndicator-linkedin
v1.0.2
Published
LinkedIn syndicator for Indiekit, supporting notes and articles
Maintainers
Readme
@rmdes/indiekit-syndicator-linkedin
LinkedIn syndicator for Indiekit, supporting notes (short text) and articles (long-form with URL card).
Originally based on work by Giacomo Debidda (jackdbd), from an unmerged pull request to the Indiekit monorepo.
Installation
npm install @rmdes/indiekit-syndicator-linkedinRequirements
- A LinkedIn account with a registered application
- OAuth scopes:
openid,profile,w_member_social - A valid access token stored in the
LINKEDIN_ACCESS_TOKENenvironment variable
Usage
Add to your Indiekit configuration:
export default {
plugins: ["@rmdes/indiekit-syndicator-linkedin"],
"@rmdes/indiekit-syndicator-linkedin": {
authorName: "Your Name",
authorProfileUrl: "https://www.linkedin.com/in/yourname",
checked: true,
},
};Options
| Option | Type | Default | Description |
| ------------------ | ------- | ---------- | ------------------------------------- |
| accessToken | string | env var | LinkedIn API access token |
| authorName | string | "" | Your name as shown on LinkedIn |
| authorProfileUrl | string | "" | Your LinkedIn profile URL |
| characterLimit | number | 3000 | LinkedIn post character limit |
| checked | boolean | false | Pre-check syndicator in Indiekit UI |
| postsAPIVersion | string | "202601" | LinkedIn API version (YYYYMM format) |
Supported Post Types
- Notes: Short text posts, syndicated as LinkedIn text posts with a permalink
- Articles: Long-form posts with a title, syndicated as LinkedIn article cards with URL, title, description, and thumbnail image. Thumbnails are resolved automatically: first from the post's featured photo, then by scraping the article's Open Graph image tag.
Known Limitations
- Token expiration: LinkedIn access tokens expire (typically after 60 days). You will need to refresh your token manually. A companion OAuth endpoint package (
@rmdes/indiekit-endpoint-linkedin) is planned to handle token acquisition through the Indiekit UI.
Credits
This package is based on the LinkedIn syndicator originally written by Giacomo Debidda as an unmerged PR to the Indiekit monorepo. Extended with article post support and adapted as a standalone package.
License
MIT
