🔥 HNLINK

Turn Hacker News into LinkedIn Virality — On Autopilot

Discover trending Hacker News stories, transform them into engaging LinkedIn posts with AI, review them in Telegram, and publish with a single tap.

Features • Workflow • Getting Started • Deployment • FAQ

Stop writing LinkedIn posts manually. Let AI do the boring part. You just approve and publish.

---

Every day, Hacker News surfaces some of the best discussions in tech.

You read an article, think "I should post about this on LinkedIn," then spend the next 20 minutes:

• Writing a hook
• Rewriting paragraphs
• Finding hashtags
• Looking for an image
• Editing the formatting
• Wondering whether it's good enough

Eventually you either publish something average...

...or don't publish anything at all.

HNLINK automates everything except the final decision.

You stay in control while AI handles the repetitive work.

• 🔥 Fetch trending Hacker News stories
• 📖 Extract complete article content
• 🖼 Automatically download the featured image
• 🤖 Generate high-quality LinkedIn posts with AI
• 📱 Review posts inside Telegram
• ✅ One-tap approval workflow
• 💼 Publish directly to LinkedIn
• 🚫 Prevent duplicate posts with SQLite history
• ⚡ Powered by OpenRouter
• 🐳 Docker ready
• ☁️ Free deployment on Hugging Face Spaces

1. Fetch Hacker News
        │
        ▼
2. Extract Article + Image
        │
        ▼
3. AI Writes LinkedIn Post
        │
        ▼
4. Send to Telegram
        │
   ┌────┴────┐
   │         │
Approve    Skip
   │         │
   ▼         ▼
LinkedIn   Archive

flowchart LR

A[Hacker News API]
--> B[Article Extractor]

B --> C[Image Extractor]

C --> D[OpenRouter AI]

D --> E[Telegram Bot]

E -->|Approve| F[LinkedIn API]

E -->|Skip| G[Discard]

HNLINK isn't just summarizing articles.

It follows a repeatable structure designed for professional social media.

Every generated post includes:

• 🎣 Attention-grabbing opening hook
• 📖 Short readable paragraphs
• 🧠 Key insights instead of article summaries
• 📈 Three-level hashtag strategy
• 💬 Conversation-starting ending
• 🚫 No Markdown
• 🚫 No URLs
• 📸 Original article image

The result is content that's ready to paste directly onto LinkedIn.

Most developers are optimizing the wrong thing.

A Hacker News discussion today highlighted a startup that
reduced infrastructure costs by nearly 80%.

Not by switching cloud providers.

Not by adding more engineers.

They simply questioned one assumption everyone else accepted.

Sometimes the biggest improvements come from deleting,
not adding.

What's one engineering decision you've changed your mind about recently?

#SoftwareEngineering
#Programming
#Startups
#HackerNews

• Python 3.10+
• OpenRouter API Key
• LinkedIn Developer App
• Telegram Bot
• LinkedIn Access Token

git clone https://github.com/Lumacodes/HNLINK.git

cd HNLINK

python -m venv .venv

source .venv/bin/activate

pip install -r requirements.txt

cp .env.example .env

Fill the environment variables.

OPENROUTER_API_KEY=sk-or-...

LINKEDIN_ACCESS_TOKEN=your_token

LINKEDIN_PERSON_URN=urn:li:person:xxxxxxxx

TELEGRAM_BOT_TOKEN=xxxxxxxx

TELEGRAM_CHAT_ID=xxxxxxxx

python src/telegram_bot.py

Open Telegram.

/fetch

Within a few seconds you'll receive generated posts with:

✅ Approve

❌ Skip

Approve publishes immediately.

Skip permanently ignores the story.

HNLINK/
│
├── src/
│   ├── telegram_bot.py
│   ├── hn_fetcher.py
│   ├── content_extractor.py
│   ├── post_generator.py
│   ├── linkedin_poster.py
│   └── history_tracker.py
│
├── config/
│   └── settings.py
│
├── scripts/
│   └── run_pipeline.py
│
├── assets/
│   └── demo.gif
│
├── Dockerfile
├── requirements.txt
└── README.md

1. Fork this repository
2. Create a Docker Space
3. Add environment variables as Secrets
4. Push your code

Your bot stays online 24/7 for free.

docker build -t hnlink .

docker run --env-file .env hnlink

• Software Engineers
• Indie Hackers
• Startup Founders
• DevRel Teams
• Technical Writers
• AI Content Creators
• Open Source Maintainers

• Reddit support
• Product Hunt support
• RSS feeds
• Multi-language generation
• Multiple LinkedIn accounts
• Scheduled publishing
• Analytics dashboard
• Custom AI prompts
• Team collaboration
• Web dashboard

Contributions are welcome.

If you have an idea, bug fix, or feature request:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

Every contribution is appreciated.

Yes.

The free tier is enough for testing and light usage.

No.

Every generated post must be approved inside Telegram.

Yes.

Any model available through OpenRouter can be used.

Absolutely.

Simply edit the prompt inside post_generator.py.

No.

Published stories are stored in SQLite to prevent duplicates.

Released under the MIT License.

Use it for personal or commercial projects.