rick/indiekit-syndicator-linkedin
1
0
Fork 0
mirror of https://github.com/rmdes/indiekit-syndicator-linkedin.git synced 2026-06-24 15:03:48 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
5 commits 1 branch 0 tags 54 KiB
  • JavaScript 100%
Find a file
Exact
Ricardo e41baa13c5 docs: add CLAUDE.md technical reference 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-13 18:23:55 +01:00
assets Initial release: LinkedIn syndicator for Indiekit 2026-02-06 17:46:28 +01:00
lib Add article thumbnail support via LinkedIn Images API 2026-02-06 18:08:19 +01:00
.gitignore Initial release: LinkedIn syndicator for Indiekit 2026-02-06 17:46:28 +01:00
CLAUDE.md docs: add CLAUDE.md technical reference 2026-02-13 18:23:55 +01:00
index.js Resolve access token dynamically at syndication time 2026-02-06 18:38:05 +01:00
package-lock.json Add article thumbnail support via LinkedIn Images API 2026-02-06 18:08:19 +01:00
package.json bump version 2026-02-06 19:16:07 +01:00
README.md Add article thumbnail support via LinkedIn Images API 2026-02-06 18:08:19 +01:00

README.md

@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-linkedin

Requirements

  • A LinkedIn account with a registered application
  • OAuth scopes: openid, profile, w_member_social
  • A valid access token stored in the LINKEDIN_ACCESS_TOKEN environment 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