- "description": "# ContentForge \u2014 Interpretable Content Intelligence\n\nYour post flopped. You'll never know exactly why if you wait until after.\n\n**ContentForge** is a 47-endpoint REST API for deterministic, white-box content scoring across 12 platforms. Every score is traceable to specific rules. Every deduction has an audit trail. No black boxes \u2014 just signal you can act on, defend to clients, and reproduce every time.\n\n**Free tier includes every endpoint. No credit card required.**\n\n---\n\n## Why ContentForge Is Different\n\nMost scoring tools are either too slow (LLM inference = 2\u201310s per call) or too vague (\"add more emotion\" isn't actionable). ContentForge uses a **pure heuristic engine** for all scoring: deterministic rules mapped to each platform's documented best practices. Same input, same score, every time \u2014 at <50ms with zero AI token cost.\n\nWhen a client asks \"why did this fail the quality gate?\", you have a defensible answer \u2014 not \"the AI said so.\" Every signal is a readable rule you can inspect, verify, or challenge.\n\nAI generation is opt-in, for when you actually need a draft written from scratch.\n\n---\n\n## \u26a1 19 Instant Endpoints \u2014 <50ms, zero AI cost\n\nEach platform has different rules. ContentForge checks the right signals for each:\n\n| Endpoint | What It Checks |\n|---|---|\n| `/v1/score_tweet` | Length, hook, hashtags (1\u20132 optimal), emojis, CTA, power words |\n| `/v1/score_linkedin_post` | Hook strength, paragraph structure, hashtag count, professional tone, CTA |\n| `/v1/score_instagram` | Hashtag count (5\u201315 optimal), emojis, hook, line breaks, CTA |\n| `/v1/score_youtube_title` | CTR signals, optimal length (40\u201360 chars), numbers, brackets, power words |\n| `/v1/score_youtube_description` | SEO keywords, timestamps, chapter marks, links, CTA placement |\n| `/v1/score_email_subject` | Open-rate signals, spam triggers, urgency, personalization tokens, length |\n| `/v1/score_tiktok` | Hook speed, hashtag strategy, trending language, ideal length (\u2264150 chars) |\n| `/v1/score_threads` | Conversational tone, question hooks, hashtag penalty, CTA |\n| `/v1/score_facebook` | Engagement triggers, question hooks, emoji density, hashtag count |\n| `/v1/score_pinterest` | Keyword density, instructional language, hashtags, spam signals |\n| `/v1/score_ad_copy` | Headline length, benefit clarity, urgency, CTA strength, compliance signals |\n| `/v1/score_readability` | Flesch-Kincaid reading ease + grade level + avg sentence/word length |\n| `/v1/analyze_headline` | Power words (60+ tracked), numbers, questions, emotional triggers, length |\n| `/v1/analyze_hashtags` | Uniqueness, spam risk, overuse, per-platform recommendations |\n| `/v1/score_multi` | Score one piece of text across **all platforms** in a single call |\n| `/v1/batch_score` | Score up to 20 draft texts against one platform \u2014 returned best-first |\n| `/v1/compare` | Head-to-head comparison of two texts with winner + advantages |\n| `/v1/ab_test` | A/B test 2-20 drafts on any platform \u2014 returns ranked list with confidence |\n\n---\n\n## \u2726 13 AI Generators \u2014 Gemini 2.5 Flash\n\nWhen you need a draft written, rebuilt, or expanded:\n\n| Endpoint | What It Returns |\n|---|---|\n| `/v1/improve_headline` | N AI-rewritten versions, each pre-scored and sorted best-first |\n| `/v1/generate_hooks` | Scroll-stopping openers for any topic (viral / professional / casual / bold) |\n| `/v1/rewrite` | Platform-optimized rewrite: Twitter, LinkedIn, Instagram, TikTok, email, blog |\n| `/v1/compose_assist` | Generate 2-5 rewrites, score each, and return the best-performing draft |\n| `/v1/tweet_ideas` | 5\u201310 tweet angles for any niche with hashtag suggestions |\n| `/v1/content_calendar` | 7-day calendar with daily themes and ready-to-post drafts |\n| `/v1/thread_outline` | Complete Twitter thread: scroll-stopping hook + numbered body + CTA |\n| `/v1/generate_bio` | Social bio for Twitter (160 chars), LinkedIn (300), or Instagram (150) |\n| `/v1/generate_caption` | Instagram or TikTok caption with hashtags, emojis, and CTA |\n| `/v1/generate_linkedin_post` | Full LinkedIn post: hook + story + insight + CTA |\n| `/v1/generate_email_sequence` | 3-email drip: welcome \u2192 value \u2192 pitch, subject lines included |\n| `/v1/generate_content_brief` | Research brief: audience, angle, SEO keywords, outline, hooks |\n| `/v1/generate_ad_copy` | Short-form ad copy variants for Facebook, Google, and Twitter |\n\n---\n\n## Quick Example\n\n**Instant score \u2014 no AI, no wait:**\n\n```\ncurl -X POST https://contentforge-api-lpp9.onrender.com/v1/score_tweet \\\n -H \"X-RapidAPI-Key: YOUR_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"text\": \"I shipped in 48 hours. Here is what I learned \ud83e\uddf5 #buildinpublic\"}'\n```\n\n**Response (~12ms):**\n\n```json\n{\n \"score\": 79,\n \"grade\": \"B\",\n \"char_count\": 59,\n \"hashtag_count\": 1,\n \"emoji_count\": 1,\n \"suggestions\": [\n \"Add a specific number to the opening hook\",\n \"Length is in the lower-optimal range \u2014 aim for 71\u2013100 chars\"\n ]\n}\n```\n\n---\n\n## Who Uses ContentForge\n\n- **Bloggers & newsletter writers** \u2014 `analyze_headline` every post before publish\n- **Twitter/X power users** \u2014 draft \u2192 score \u2192 only post A/B-grade content\n- **Indie hackers & founders** \u2014 daily `tweet_ideas` for your build-in-public niche\n- **Content agencies** \u2014 generate full monthly calendars in seconds\n- **Copywriters** \u2014 `rewrite` any text for a different platform instantly\n- **Email marketers** \u2014 score subject lines for higher open rates\n- **Developers** \u2014 clean JSON, CORS enabled, consistent schemas, fits any stack\n\n---\n\n## Plans\n\nInstant endpoints (`score_*`, `analyze_*`, `batch_score`, `health`) never count against AI call quota.\n\n| Plan | Price | AI Calls/mo | Requests/mo | Rate Limit |\n|---|---|---|---|---|\n| **BASIC** | Free | 50 | 300 | 30 req/min |\n| **PRO** | $9.99/mo | 750 | 1,000 | 30 req/min |\n| **ULTRA** | $29.99/mo | 3,000 | 4,000 | 30 req/min |\n| **MEGA** | $99/mo | 18,000 | 20,000 | 30 req/min |\n\n---\n\n**Live demo (no API key needed):** https://captainfredric.github.io/ContentForge/\n\n**GitHub:** https://github.com/CaptainFredric/ContentForge\n\n**Support:** captainarmoreddude@gmail.com\n\n---\n\n## Proof Dashboard\n\nTrack score delta, publish outcomes, and estimated revenue lift with:\n- `/v1/record_score_delta`\n- `/v1/record_publish_outcome`\n- `/v1/record_revenue`\n- `/v1/dashboard_stats`\n- `/v1/proof_timeline`\n- `/v1/export_proof_report`\n- `/v1/proof_recommendations`\n- `/v1/cohort_benchmarks`\n\n---\n\n## QOps Layer (v1.7.0)\n\nEvery scoring endpoint now returns structured quality operations fields:\n\n- `quality_gate`: `PASSED` | `REVIEW` | `FAILED` \u2014 deterministic audit verdict (≥70 / 50-69 / <50)\n- `operational_risk`: `LOW` | `MEDIUM` | `HIGH` \u2014 risk band paired to quality gate\n\n`/v1/improve_headline` additionally returns:\n- `lift_percentage`: measurable score delta from original to best version (e.g. `\"+109%\"`)\n- `time_to_improve_ms`: end-to-end wall-clock ms\n- `audit_summary`: LLM-generated 1-2 sentence agency brief (when AI is available)\n\n`GET /v1/platform_friction` \u2014 real-time platform friction signals for content workflows. Returns `friction_level` LOW / MEDIUM / HIGH plus per-account state breakdown.\n",
0 commit comments