content-factory

name	content-factory
description	Build exactly two SEO-friendly AI-tool articles per run by reading ~/openclaw-work/clients/<client>/config.json, scraping configured RSS + HTML sources, and writing markdown to ~/openclaw-work/out/articles/YYYY-MM-DD/<slug>.md. Trigger whenever a contributor needs trend-based AI tool content with outline, FAQ, and metadata prefilled.

Content Factory

Overview

Automates the creation of two SEO-grade articles that track trending AI tools: it pulls from curated feeds, assembles outlines/sections/FAQs, and drops polished markdown drafts into the dated out/articles folder.

Quick Start

1. Prepare client config at ~/openclaw-work/clients/<client>/config.json (schema + example in references/config-and-production.md). Include persona, CTA, RSS/HTML sources, and at least two article specs with keywords.
2. Install dependencies (once):

   pip install requests beautifulsoup4
   

3. Run the factory:

   cd /Users/chenjiaxuan/openclaw/skills/content-factory
   python scripts/run_content_factory.py --client <client-slug>
   

   Optional flags: --date YYYY-MM-DD, --max-per-source 10, --dry-run, --init-dirs.
4. Polish outputs in ~/openclaw-work/out/articles/<date>/. Each run emits exactly two markdown files with frontmatter, outline, sections, FAQ, meta description, keywords, CTA, and source notes.

Workflow

1. Configure Inputs

• persona, cta, and ordered articles[] entries (slug, title, primary keyword, keywords, angle, hook, optional outline/section/FAQ/meta overrides) live in the client config.
• Define ≥1 source of trending AI tools:
  • html-list: provide item_selector, title_selector, description_selector, link_selector.
  • rss: supply feed URL.
  • api: optional path + mapping to shape JSON payloads.
• Use references/config-and-production.md for the full JSON contract and checklist.

2. Harvest Signals (Web RSS + HTML)

• scripts/run_content_factory.py fetches all configured sources, dedupes tool names, and caps each feed via --max-per-source.
• HTML scraping relies on BeautifulSoup; inspect upstream DOM changes and adjust selectors as needed.
• RSS parsing runs through xml.etree; API payloads are navigated with dot-paths.

3. Generate Two SEO Articles

• The script always loads assets/seo-article-template.md twice—once per article spec.
• Template injects: YAML frontmatter (title, slug, keywords, meta description), numbered outline, three narrative sections, featured tool table, FAQ block, CTA, and source notes.
• Exactly two articles are produced each run (first two entries in articles[]). Missing entries cause the script to exit with an error.

4. QA & Delivery

• Ensure primary_keyword appears in intro, meta description, and CTA.
• Confirm at least three tools populate the table; bump --max-per-source if the feeds run light.
• Use --dry-run to preview markdown while refining selectors, outline bullets, or FAQ copy.

Scripts

Path	Purpose
scripts/run_content_factory.py	CLI orchestrator. Reads the client config, scrapes RSS/HTML/API sources, fills the SEO template twice, and writes markdown to ~/openclaw-work/out/articles/<date>/. Supports --init-dirs, --dry-run, and --max-per-source.

References & Assets

• references/config-and-production.md: Config schema, selector guidance, and quality checklist.
• assets/seo-article-template.md: Markdown boilerplate with outline, sections, FAQ, CTA, meta description, and source note placeholders.