voice-to-article

agent
Security Audit
Warn
Health Warn
  • No license Ò€” Repository has no license file
  • Description Ò€” Repository has a description
  • Active repo Ò€” Last push 0 days ago
  • Community trust Ò€” 11 GitHub stars
Code Pass
  • Code scan Ò€” Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions Ò€” No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

πŸŽ™οΈ Voice β†’ Article: AI SEO copywriting pipeline. Dictate blog posts in Telegram, get SEO-optimized articles deployed to your site. For solopreneurs.

README.md

πŸŽ™οΈ Voice β†’ Article

5 minutes of talking. Published SEO article. $0.12.



The problem

Your site is empty. Not because you have nothing to say β€” because writing takes 5 hours you don't have.

The fix

Open Telegram. Hit record. Explain your thing like you're talking to a friend.

AI transcribes β†’ researches trending keywords β†’ writes the article in your voice β†’ deploys it to your site with schemas, meta, cross-links, and sitemap.

πŸ“± Voice memo  β†’  πŸ” Semantics  β†’  ✍️ Article  β†’  πŸš€ Live on site
      5 min            auto            auto             auto

No Ahrefs. No Semrush. No blank page. Just you and your phone.


What It Does

  1. You send voice notes β†’ Telegram bot transcribes via Whisper
  2. AI extracts structure β†’ thesis, sections, FAQ, keywords
  3. Semantic research β†’ Yandex Wordstat (RU) or Google Suggest (EN) for trending topics
  4. AI writes the article β†’ DeepSeek (or Claude/GPT) β€” SEO-optimized, human-readable
  5. Auto-deploy β†’ FTP/SCP to your site + GitHub markdown backup
  6. Schema markup β†’ Article + FAQPage JSON-LD for AI search visibility (AEO)

Built for Hermes Agent. Portable to Claude Code, Codex CLI, Cursor, or any LLM agent.


Why This Exists

Writing blog posts sucks. Editing AI-generated fluff sucks more. This pipeline preserves your voice β€” slang, personality, directness β€” while handling the boring parts: semantics, structure, SEO tags, deployment.

The solopreneur content flywheel:

Voice memo (5 min) β†’ Published SEO article (forever)

No dashboards. No content calendars. Just talk about what you know.


vs. The Old Way

The Old Way This Tool
Open Ahrefs β†’ keyword research (1h) AI researches semantics automatically
Outline in Notion (30 min) AI extracts structure from your voice
Write draft (2h) You talked β€” that's the draft
Edit, re-edit, stare at screen (1h) AI writes in your voice, not corporate fluff
Manually add meta tags, schema, OG (30 min) Article+FAQPage Schema auto-generated
FTP/SCP upload, sitemap, cross-links (30 min) Auto-deploy + sitemap + cross-links
Total: 5+ hours Total: 5 minutes of talking

Tools this replaces for a solopreneur:

  • Ahrefs / Semrush β€” keyword research. Replaced by Wordstat (RU) + Google Suggest (EN) + AI clustering.
  • Jasper / Copy.ai / Writesonic β€” AI copywriting. Replaced by DeepSeek with your voice prompt.
  • SurferSEO / Clearscope β€” content optimization. Replaced by semantic cluster injection into Article Schema.
  • WordPress / Ghost / Webflow β€” CMS. Replaced by static HTML deploy via SCP/FTP.
  • Yoast / RankMath β€” on-page SEO. Replaced by auto-generated meta, hreflang, schema, canonical.
  • A human copywriter β€” $200-500/article. Replaced by $0.12 of API calls.

You still need a brain. You still need expertise. But you no longer need 6 tools and an afternoon to publish one article.


Who Is This For

  • Solopreneurs who need content but hate writing
  • Indie hackers launching products with zero marketing team
  • Consultants/agencies who think out loud and want that published
  • Non-writers with domain expertise and a phone

Tech Stack & Cost

Component What It Does Cost
Telegram Bot Receives voice messages Free
Whisper (OpenAI) Speech-to-text $0.006/min (~$0.10/article)
DeepSeek API Article generation + semantics ~$0.015/article
Yandex Wordstat RU keyword research ~$0.005 per 100 queries
Your server Host the published HTML Whatever you pay

~$0.12 per published article. Cheaper than a coffee. Better ROI than most ad spend.


Setup (5 minutes)

1. Create a Telegram Bot

Talk to @BotFather β†’ /newbot β†’ get token

2. Get API Keys

3. Configure Your Agent

Hermes Agent:

# Add the skill
cp SKILL.md ~/.hermes/profiles/marketing/skills/

# Set env vars
export OPENAI_API_KEY="sk-..."
export DEEPSEEK_API_KEY="sk-..."
export TELEGRAM_BOT_TOKEN="123:abc"

Claude Code / Codex / Cursor:

# Copy PROMPT.md into your agent's system prompt or .cursorrules
# Add API keys to your environment

4. Point It at Your Site

Edit SKILL.md β†’ update deploy section with your FTP/SCP credentials and paths.

5. Start Dictating

Send a voice message to your bot. The agent picks it up, transcribes, structures, writes, and deploys.


The Workflow (Visual)

πŸ“± Telegram Voice Note
        ↓
πŸ—£οΈ OpenAI Whisper β†’ Raw transcript
        ↓
🧠 AI extracts: thesis, sections, FAQ, keywords
        ↓
πŸ” Yandex Wordstat (RU) / Google Suggest (EN) β†’ Trending semantics
        ↓
✍️ DeepSeek writes: HTML article with Article+FAQPage Schema
        ↓
πŸš€ Deploy: FTP/SCP to your site + GitHub markdown
        ↓
πŸ“Š SEO: sitemap update, cross-links, search engine ping

Real Numbers

From my production pipeline (axelfreeman.com + axelfreeman.ru):

  • 83 published Q&A pages (44 RU + 39 EN)
  • ~100K monthly search impressions across both languages
  • 4-6 FAQ items per page with FAQPage Schema
  • Article published in <2 minutes after voice memo received

The Semantic Engine

This isn't "AI wrote me a blog post." This is:

  • Trending topic detection β€” Wordstat dynamics to find what's growing
  • Cluster analysis β€” group keywords by intent, not just volume
  • Exact match filtering β€” broad numbers lie, exact match tells the truth
  • Cross-language β€” RU via Yandex, EN via Google Suggest

Example semantic clusters for "AI copywriting" (RU market):

Cluster Volume Top Phrase
AI text generation 330K/mo Π½Π΅ΠΉΡ€ΠΎΡΠ΅Ρ‚ΡŒ тСкст
AI for writing 36K/mo ΠΈΠΈ для написания тСкстов
Voice β†’ text 70K/mo Π°ΡƒΠ΄ΠΈΠΎ Π² тСкст
SEO copywriting 170/mo seo тСкст сайт
Content creation 60K/mo созданиС ΠΊΠΎΠ½Ρ‚Π΅Π½Ρ‚Π°

Full semantic data: semantics/ directory.


Example

Input: 5-minute voice memo about why Telegram is the best platform for AI agents.

Output: Published article on axelfreeman.com with:

  • SEO title + meta description
  • 8 H2 sections with bullet points
  • 2 card blocks (key insight + CTA)
  • 6 FAQ with matching JSON-LD Schema
  • hreflang cross-link to RU version
  • Yandex Metrika tracking

See examples/ for the full before/after.


Portability

Agent How to Use
Hermes Agent Drop SKILL.md into skills directory
Claude Code Paste PROMPT.md into CLAUDE.md
Codex CLI Copy to .codex.md or pass as system prompt
Cursor Add to .cursorrules
Any LLM PROMPT.md works as a standalone system prompt

Files

voice-to-article/
β”œβ”€β”€ README.md              ← You are here
β”œβ”€β”€ SKILL.md               ← Hermes Agent skill (full pipeline)
β”œβ”€β”€ PROMPT.md              ← Universal system prompt for any LLM agent
β”œβ”€β”€ SETUP.md               ← Detailed setup: bots, keys, deploy targets
β”œβ”€β”€ semantics/
β”‚   β”œβ”€β”€ ru-clusters.json   ← RU keyword clusters (Wordstat)
β”‚   └── en-suggestions.json← EN keyword suggestions (Google Suggest)
β”œβ”€β”€ examples/
β”‚   β”œβ”€β”€ voice-memo-raw.txt ← Raw transcript of a real voice memo
β”‚   β”œβ”€β”€ article-ru.html    ← Final published RU article
β”‚   └── article-en.html    ← Final published EN article
└── .github/
    └── FUNDING.yml

Read Also


License

MIT β€” use it, remix it, ship it. If this saves you time, buy me a coffee.

Reviews (0)

No results found