⚡ 100% Free & Open-Source Autonomous Agent

Automate LinkedIn
On Autopilot

Autonomous AI engine that finds trending tech stories with Tavily, analyzes insights with Claude Fable, drafts punchy human-like posts, and publishes on schedule via GitHub Actions.

📦 Download ZIP ☕ Buy Me a Coffee

⚡ How The Pipeline Works

📰

1. Discover

Tavily Search retrieves fresh tech news.

🧠

2. Analyze

Claude selects the highest-impact story.

🎯

3. Tailor

Adapts to your custom skills and tone.

✍️

4. Write

Drafts high-engagement copy without clichés.

📢

5. Publish

Posts automatically via official LinkedIn API.

Prerequisites

What Is Needed?

Everything you need before running the automation. All services have generous free tiers!

🤖
AI Brain

1. Anthropic API Key

Powers Claude Fable for selecting top stories and drafting high-retention content without generic AI fluff.

Secret Key 
ANTHROPIC_API_KEY
🔎
Search API

2. Tavily Search API

Real-time developer and AI search engine designed for autonomous agents. Grabs clean, high-signal articles.

Secret Key 
TAVILY_API_KEY
🔗
Social OAuth

3. LinkedIn App Credentials

Create a free app at the LinkedIn Developer Portal to get your Client ID, Secret, and long-lived Refresh Token.

Required OAuth Scopes
w_organization_social w_member_social
⚡
Free Runner

4. GitHub Actions Runner

Zero hosting fees! GitHub Actions executes the cron job inside your repo completely free on Linux cloud runners.

Runtime Environment 
ubuntu-latest (Node 20)
Step-by-Step

How To Use It

Get up and running locally and in GitHub in 4 simple steps.

1

Clone Repository & Install Dependencies

Download the repository ZIP or clone it, then install the fast dependencies inside code/:

Terminal 
git clone https://github.com/farukhetro/Linkedin-automation.git
cd Linkedin-automation/code
npm install
2

Get LinkedIn OAuth Refresh Token

Set your Client ID and Client Secret in code/.env.local, then run the built-in OAuth helper:

Terminal 
npm run auth

This launches a local callback server, authenticates via your browser, and prints your long-lived Refresh Token directly in your terminal.

3

Customize Your Skills (Blank & Flexible)

The root skills/ folder is completely blank so you can add your own custom skills! Simply drop any skills.txt, profile.json, or markdown file into skills/ and Claude will tailor every post to your unique tone and expertise.

4

Test The Automation Locally

Trigger the end-to-end flow to fetch articles, analyze trends, write a post, and publish to LinkedIn:

Terminal 
npm run start
Cloud Setup

GitHub Actions Automation

Configure repository secrets and let GitHub Actions run your content schedule 24/7.

GitHub Secrets Checklist

Go to your GitHub repository: Settings > Secrets and variables > Actions > New repository secret. Add the following secrets:

Secret Name Description Action
ANTHROPIC_API_KEY Your Claude API Key
TAVILY_API_KEY Your Tavily Search API Key
LINKEDIN_CLIENT_ID LinkedIn Developer App Client ID
LINKEDIN_CLIENT_SECRET LinkedIn Developer App Client Secret
LINKEDIN_REFRESH_TOKEN Refresh Token from npm run auth
LINKEDIN_ORGANIZATION_ID Your Company / Organization Page ID
⏰

5 Daily Scheduled Windows

Configured in .github/workflows/cron.yml for optimal global engagement:

  • 4:50 AM ET (Commuter feed)
  • 12:59 PM ET (Lunch break)
  • 4:45 PM ET (Afternoon wrap-up)
  • 7:45 PM ET (Evening tech discussion)
  • 9:07 PM ET (Late night browsing)
🌐

Automated GitHub Pages

This documentation site deploys automatically via GitHub Actions:

  1. Open your repo Settings on GitHub.
  2. Click Pages in the left sidebar.
  3. Under Source, select GitHub Actions.
  4. Push your code — GitHub Actions builds and deploys .github/pages/ automatically!
Frequently Asked

Common Questions

Everything you need to know about our autonomous AI LinkedIn publisher.

❓

What is LinkedIn Automation?

It is an open-source autonomous agent that monitors real-time tech trends using Tavily Search, evaluates insights with Claude Fable AI, and schedules publication via GitHub Actions completely free.

💰

How much does it cost to run?

100% free! GitHub Actions includes generous free cloud runner minutes, and all required APIs (Anthropic, Tavily, LinkedIn Developer) offer free tiers suitable for consistent posting.

✍️

How does it avoid robotic AI fluff?

The system analyzes your custom skills and tone from the skills/ folder, scoring stories on technical substance and producing authentic, human-like copy without buzzwords.

🔑

What credentials are required?

You only need an Anthropic Claude API Key, Tavily Search API Key, and your LinkedIn Developer App credentials (Client ID, Client Secret, Refresh Token).

☕ Support Our Open-Source Project!

This project is 100% free and open source. If it saves you hours of writing and research, consider buying us a coffee on Ko-fi to support continuous updates!

☕ Buy Me a Coffee on Ko-fi ⭐ Star on GitHub