# TopicForge

> TopicForge turns topics into publish-ready SEO articles via a four-stage AI pipeline — outline, draft, voice, and CTA — with editorial guardrails, FAQ schema, and batch API support.

TopicForge is pay-per-article programmatic SEO for agencies and developers. No subscription required.

## Product

- Batch API: POST /v1/jobs with up to 100 topics per job
- Pay-per-article pricing: $10 single, $49/10-pack, $399/100-pack
- Free SEO tools: topic clusters, FAQ schema, meta descriptions
- Free sample funnel: one personalized article per email (limited availability)

## Agent integration

- MCP server (npm): `npx -y @topicforge/mcp` — stdio transport for Claude Desktop, Cursor, Claude Code, Windsurf, n8n
- MCP registry name: `net.topicforge/mcp`
- Fallback tarball: `npx -y https://topicforge.net/mcp/topicforge-mcp-0.1.0.tgz`
- WebMCP: free tools at https://topicforge.net/tools/* expose browser-native agent tools (Chrome early preview)
- REST API: OpenAPI spec at https://topicforge.net/openapi.json
- Developer docs + one-click install: https://topicforge.net/developers

## MCP tools

- topic_cluster — expand a seed topic into 15–25 article ideas
- faq_schema — FAQ questions + FAQPage JSON-LD
- meta_description — 150–160 char meta description
- run_batch — launch a credit-debited batch job ($10/article, packs from $3.99)
- get_batch_status — poll batch job progress
- get_article — fetch article by ID
- export_markdown — export article as markdown

## Setup

1. Sign in at https://topicforge.net/login
2. Create API key at https://topicforge.net/app/settings/api-keys
3. Buy credits at https://topicforge.net/app/billing
4. Install MCP: `npx -y @topicforge/mcp` with env `TOPICFORGE_API_KEY=tf_live_...`

## Links

- Home: https://topicforge.net/
- Developers: https://topicforge.net/developers
- Free tools: https://topicforge.net/tools
- Pricing: https://topicforge.net/pricing
- Free sample: https://topicforge.net/free-sample
- Examples: https://topicforge.net/examples
- Guides: https://topicforge.net/guides
- GitHub (MCP package): https://github.com/TopicForge/topicforge-mcp

## API base

- Production: https://api.topicforge.net/v1
- Authentication: Bearer API key (tf_live_...) or Firebase JWT for dashboard