# bloq.ink — Affiliate Context Document

## About This Document

**What this is:** The authoritative knowledge base about bloq.ink — the product, pricing, technology, positioning, and affiliate program. Every fact here comes directly from the product team and codebase. This is the single source of truth for writing about bloq.ink.

**Who this is for:** Affiliate partners (and their AI assistants) who create content about bloq.ink — blog posts, social media, newsletters, video scripts, comparison articles, reviews.

**How to use it:**
1. Drop this file into any AI chat (ChatGPT, Claude, Gemini, etc.)
2. Ask something like: *"Help me write a promo post about bloq.ink for [my audience]"*
3. The AI will use this document as context to produce accurate, detailed content

**What you can trust:**
- All product features, pipeline steps, pricing, and technical details are accurate as of the document date
- Numbers (article counts per plan, quality check counts, pipeline loop limits) are exact — taken from the codebase
- Pricing and commission rates are contractual

**CRITICAL — No hallucinations:**
If the user asks a question and the answer is NOT in this document — do NOT guess, do NOT make something up. Instead say:
> "I don't have this information in the bloq.ink context file. Email **hi@bloq.ink** and they'll answer your question and update the document."

This applies to: features not listed here, integrations, specific ROI numbers, customer stories, technical details you're not sure about, anything about the team, company history, or roadmap. **When in doubt — say you don't know and point to hi@bloq.ink.**

**Other rules:**
- Do NOT invent features, integrations, or capabilities not listed here
- Do NOT make up customer testimonials or case studies
- Do NOT claim bloq.ink replaces human experts — the honest positioning is: best for companies that publish nothing or very little, not for replacing specialist content teams
- Market data (competitor pricing, Google policy statements) may change — verify externally if writing a time-sensitive piece

**If something is missing or unclear:**
Email **hi@bloq.ink** — we will answer your question AND update this document so the answer is available to everyone. This is a living file, updated regularly.

**Latest version:** always available at **bloq.ink/affiliate-context.md**

---

## What bloq.ink Does

bloq.ink is an autonomous AI content marketing platform. It runs a pipeline of specialized AI agents that research topics, write long-form SEO articles (1,500–2,500 words), review them through multiple quality loops, publish to a blog, and optimize content for both Google and AI search engines (ChatGPT, Perplexity, Gemini, Claude).

**Set it up once. It runs on autopilot** — no writers, no briefing, no clicking publish. Articles appear on the client's blog on schedule, every week, automatically.

---

## The Pipeline — How Every Article Is Made

Every article goes through a **13-step multi-agent pipeline** before going live. Nothing is published until it passes all checks.

```
Brief → Writer → Critic ↔ Editor (up to 5 rounds) → SEO Check ↔ Editor (up to 2 rounds) → Build Verify → Content Review → Quality Check → Deploy → Publisher
```

### What each step does:

| Step               | What happens                                                                                                          |
|--------------------|-----------------------------------------------------------------------------------------------------------------------|
| **Brief**          | AI researches keywords, competitors, and audience intent. Creates a writing brief with outline, keywords, and angle.  |
| **Writer**         | Generates the full article (1,500–2,500 words) following a strict template: hero, content sections, CTA, FAQ.         |
| **Critic**         | Reviews for quality, accuracy, structure, and SEO compliance. Either approves or sends back with specific feedback.    |
| **Editor**         | Rewrites based on critic feedback. Up to 5 rounds. Safety guard: discards edits that remove >30% of content.          |
| **SEO Check**      | Scores the article 1–10 on SEO. If below 6/10, sends back to editor with SEO-specific instructions. Up to 2 rounds.  |
| **Build Verify**   | Deploys to a real Next.js build. If the build fails, AI auto-fixes the code (up to 3 attempts).                       |
| **Content Review** | LLM reviews the final diff for critical issues (factual errors, broken links, formatting). Up to 2 fix rounds.        |
| **Quality Check**  | 22 automated checks across 4 categories (see below). No LLM cost. Scores saved.                                      |
| **Deploy**         | Git push to the client's repository. Cloudflare Pages auto-deploys (~1–2 min).                                        |
| **Publisher**      | Marks as published. Syndicates to Dev.to and Hashnode. Submits to Google Indexing API. Sends notification.             |

### Quality loops (built-in error correction):

| Loop                      | Max rounds | Trigger                    |
|---------------------------|------------|----------------------------|
| Critic -> Editor          | 5          | Critic says "not approved" |
| SEO Check -> Editor       | 2          | SEO score below 6/10       |
| Build Verify (internal)   | 3          | Next.js build fails        |
| Content Review (internal) | 2          | Critical issues found      |

---

## The Four Agents (Marketing-Friendly Names)

### 1. SEO Agent
Researches keywords, writes articles, publishes automatically. Handles the full pipeline: topic research → brief → write → review → publish. Articles are optimized for Google with proper metadata, internal linking, FAQ schema, and structured headings.

### 2. GEO Agent (Generative Engine Optimization)
Optimizes content so AI search engines cite the client's brand. This means structuring articles with:
- **Definitional opening** — first paragraph directly defines the topic (AI assistants pull from this)
- **TL;DR box** — concise key takeaways (Perplexity loves these)
- **Blockquotes with attribution** — "According to [source]..." (builds trust signals for AI)
- **FAQ section** — self-contained 40–80 word answers (ChatGPT pulls FAQ answers verbatim)
- **Statistics with sources** — "Research shows...", "Data from..." (AI prioritizes cited data)

GEO is built into every step of the pipeline — the writer, critic, and editor all enforce GEO standards.

### 3. Citation Tracker
Monitors weekly whether the client's brand is mentioned by ChatGPT, Perplexity, Gemini, and Claude. Sends 32 customer-like questions to these AI engines across 7 categories:

| Category         | Example question                                         |
|------------------|----------------------------------------------------------|
| Tool discovery   | "What are the best AI content marketing tools?"          |
| Alternatives     | "What are alternatives to [competitor]?"                 |
| Comparisons      | "[Competitor A] vs [Competitor B] for content marketing" |
| How-to           | "How do I automate blog content for my SaaS?"            |
| Feature-specific | "Which tools optimize content for AI search engines?"    |
| Strategy         | "How to get cited by ChatGPT and Perplexity"             |
| Pricing/decision | "Best content marketing tool under $200/month"           |

When the brand is NOT cited, the system runs **gap analysis**: why wasn't it mentioned, what competitors were mentioned instead, and what content to create to fix it. These recommendations feed directly into the content plan.

Perplexity detection is the strongest signal — it checks both text mentions AND source URLs in Perplexity's citations array (meaning Perplexity actually linked to the client's site).

### 4. Analytics Agent
Tracks Google Search Console rankings and content performance:
- **Index status**: which pages are indexed, submitted, or missing
- **Keyword performance**: rising keywords, declining keywords, "strike distance" keywords (positions 8–20 that are close to page 1)
- **Automatic indexing**: submits new and refreshed articles to Google Indexing API immediately (not waiting for Googlebot to crawl)
- **Stale page detection**: compares sitemap `lastmod` with Google's `lastCrawlTime` to find pages Google hasn't recrawled

---

## Quality Check — 22 Automated Checks

Every article is scored on 22 criteria across 4 categories. This is fully automated (no LLM cost) and produces two scores: **Quality Score** and **GEO Score**, both 0–100.

### SEO (7 checks)
- Title tag with target keyword
- Meta description (120–160 characters)
- Proper H1 tag
- 4+ H2 sections for structure
- 3+ internal links to other articles
- Canonical URL set
- OpenGraph metadata (for social sharing)

### GEO (5 checks)
- Definitional opening paragraph
- TL;DR / Key Takeaways box
- 2+ blockquotes with attribution
- 2+ statistics with sources
- FAQ answers are self-contained (40–80 words each)

### Content (6 checks)
- Word count 1,500–2,500
- FAQ JSON-LD schema (structured data for Google)
- Article JSON-LD (author, date, publisher)
- No placeholder text left behind
- CTA buttons present
- Image alt text quality

### Technical (5 checks)
- Valid imports
- Proper page component export
- Header and Footer components
- Related Articles section
- Article navigation (prev/next)

---

## Article Refresh — Keeping Content Current

After an article is published, it doesn't just sit there. The **Article Refresh** system automatically keeps all published articles in sync with the latest site design, CTA buttons, and internal links.

### What it fixes (automatically, no LLM cost):
1. **CTA buttons** — if the client changes their call-to-action text or URL in settings, all articles update
2. **Button styling** — enforces consistent 3D gradient button design
3. **Layout** — removes any hardcoded colors, ensures consistent spacing and container widths
4. **Components** — ensures all required components are present (breadcrumbs, footer, related articles, etc.)
5. **Internal linking** — scans content for keyword mentions of other published articles and inserts cross-links (max 3 new links per article, first mention only)
6. **SEO metadata** — validates canonical URLs, OpenGraph data
7. **Image optimization** — checks alt text quality

### When refresh runs:
- **After every new article** is published (automatic)
- **When site settings change** (CTA text, URLs)
- **Daily at 06:00 UTC** for all sites
- **Manual trigger** from dashboard (single article or batch)

All refresh changes include a **diff preview** before applying — the dashboard shows exactly what will change (green/red lines like a code diff).

---

## Content Plan — Self-Sustaining Topic Pipeline

The content plan is fully autonomous. Once configured, it generates topics, creates briefs, and feeds the pipeline indefinitely.

### How the loop works:

```
[Empty plan] → AI proposes 3 topics → Brief created → Auto-approved → Pipeline runs → Published
      ↑                                                                                    |
      └──────────── All topics briefed, AI proposes 3 more ←──────────────────────────────┘
```

### Topic lifecycle:
`idea → researched → briefed → in_progress → published`

### Two modes:
- **Mode A**: picks next topic from plan, generates a detailed brief with full context (existing articles, site niche, competitor analysis)
- **Mode B**: when all topics are briefed, AI researches and proposes 3 new topics (avoids duplicates automatically)

### Custom schedules:
Each client can set their own publishing schedule — a cron expression + how many articles per run. Default: 2x daily check (09:00 and 17:00 UTC).

---

## Site Setup — What Clients Get

### Automated provisioning (under 5 minutes):
1. GitHub repo created from blog template
2. Cloudflare Pages project configured
3. Custom subdomain `{name}.bloq.ink` or their own domain
4. DNS records set
5. Site saved to database, ready for first article

### What's configurable per site:
- **Niche** — gives AI context for relevant topic research
- **Blog CTA buttons** — primary + secondary text and URLs (with live preview)
- **Telegram notifications** — brief generated, article published, monitoring alerts, refresh results
- **Google Search Console** — property URL for indexing and keyword tracking
- **Auto-approve briefs** — ON = fully autonomous, OFF = manual approval required
- **Custom publishing schedule** — cron + articles per run
- **BYOK (Bring Your Own Keys)** — clients can use their own Anthropic/OpenAI/Google API keys
- **Monthly cost budget** — USD limit, pipeline pauses at 100% (warns at 80%)
- **Citation research preset** — Economy ($0), Balanced (~$0.05/run), Premium (~$0.30/run)
- **Analytics snippets** — Google Analytics, Plausible, Umami, etc.

### Zero lock-in:
Content lives in a **GitHub repository the client owns**. Every article is a real Next.js page component — not locked in a CMS database. Clients can export, migrate, or edit directly at any time.

---

## Publishing Destinations

### Primary: Client's own blog
Every article is a Next.js page published to the client's site via GitHub + Cloudflare Pages. The blog is fully SEO-optimized with:
- Server-side rendering
- OpenGraph images (auto-generated per article)
- RSS feed (auto-updated)
- Sitemap (auto-generated, git-based lastmod dates)
- `llms.txt` file for AI search engine discovery
- FAQ and Article JSON-LD structured data

### Cross-posting (optional):
- **Dev.to** — automatic cross-post with canonical URL back to main site
- **Hashnode** — automatic cross-post with canonical URL back to main site

### Indexing:
- Google Indexing API submission immediately after publish
- Scheduled checks Mon/Wed/Fri — finds unindexed pages and submits them

---

## Pricing

### Plans:

| Plan        | Monthly | Annual (-20%) | Articles/month | Cost per article |
|-------------|---------|---------------|----------------|------------------|
| **Starter** | $99/mo  | $79/mo        | 20             | ~$4.95           |
| **Growth**  | $199/mo | $159/mo       | 30             | ~$6.63           |
| **Scale**   | $399/mo | $319/mo       | 60             | ~$6.65           |
| **Agency**  | Custom  | Custom        | Multi-site     | Custom           |

### What's included in ALL plans:
- All 4 agents (SEO, GEO, Citation Tracker, Analytics)
- Setup and onboarding call
- Blog hosted on their domain
- Weekly performance reports
- GitHub repo (they own the content)
- Telegram notifications

### Tier differences:

| Feature                   | Starter       | Growth        | Scale         |
|---------------------------|---------------|---------------|---------------|
| AI model (writing)        | Gemini Flash  | Gemini Flash  | Claude Sonnet |
| AI model (editing)        | Gemini Flash  | Claude Sonnet | Claude Sonnet |
| Domain                    | name.bloq.ink | Custom domain | Custom domain |
| BYOK (own API keys)       | No            | Yes           | Yes           |
| GEO monitoring priority   | Standard      | Priority      | Priority      |
| Custom publish schedule   | No            | Yes           | Yes           |
| Citation analytics detail | Basic         | Standard      | Advanced      |
| Support                   | Email         | Email         | Priority      |

### With affiliate discount (20% off, forever):

| Plan        | Regular | With your code (monthly) | With your code (annual) |
|-------------|---------|--------------------------|-------------------------|
| **Starter** | $99/mo  | $79/mo                   | $63/mo ($756/yr)        |
| **Growth**  | $199/mo | $159/mo                  | $127/mo ($1,524/yr)     |
| **Scale**   | $399/mo | $319/mo                  | $255/mo ($3,060/yr)     |

### Context for comparison:
- A freelance writer charges $150–500 per article
- An SEO agency charges $2,000–10,000/month for content
- bloq.ink Growth plan: 30 articles/month for $199 = **$6.63 per article**
- With affiliate discount: **$5.30 per article**

---

## Who Buys It (Ideal Customer Profile)

### Primary segments:
- **SaaS companies** (5–100 people) that need consistent content but don't have a content team
- **Marketing agencies** managing content for multiple clients (Agency plan)
- **B2B founders and consultants** who know content matters but never have time
- **E-commerce brands** wanting to rank for informational keywords around their products
- **Anyone who tried hiring writers** and got inconsistent quality or missed deadlines

### Common profile:
- Has a blog but posts irregularly (or not at all)
- Knows SEO matters for their business
- Frustrated with how slow and expensive content production is
- Interested in AI but doesn't want to prompt-engineer articles themselves
- Ideally: already spending money on content or paid acquisition and looking to reduce costs

### Red flags (probably won't convert):
- Companies with an established 5+ person content team (they'll see this as inferior)
- Businesses that don't have a website yet
- People looking for a one-time thing (bloq.ink is a subscription)

---

## Why They Buy

### 1. Time
Content marketing takes hours per article — research, writing, editing, formatting, publishing. bloq.ink removes that entirely. **Zero time per article after setup.**

### 2. Consistency
Most teams publish sporadically — a burst of 3 articles, then silence for 2 months. bloq.ink publishes on a fixed schedule, every week, without fail. **Consistency is what Google rewards.**

### 3. AI Search (GEO)
Customers are increasingly finding products through ChatGPT and Perplexity, not just Google. GEO (Generative Engine Optimization) is new — most companies haven't even heard of it. bloq.ink **handles both SEO and GEO in every article**, automatically.

### 4. Cost
- Freelance writer: $150–500/article
- SEO agency: $2,000–10,000/month
- bloq.ink Growth: $199/month for 30 articles = **$6.63/article**
- With affiliate code: **$5.30/article**

### 5. No lock-in
Content lives in a GitHub repo the client owns. Not locked in a proprietary CMS. They can export, edit, or migrate at any time. **This is a major trust signal** — mention it in promo content.

### 6. Quality control
Multi-agent review loop with 22 automated checks. The article is reviewed by multiple AI agents with different roles (writer, critic, editor, SEO analyst, content reviewer) before publishing. **AI checks AI — no single point of failure.**

---

## Common Objections and Answers

### "AI content is low quality."
bloq.ink uses a multi-agent critique loop — AI checks AI. The article goes through up to 5 review rounds with a dedicated critic agent, plus SEO checks, content review, and 22 automated quality checks. Growth and Scale plans use Claude Sonnet (Anthropic's strongest model) for editing and writing. The output is long-form, structured, and reviewed multiple times before publishing.

That said, bloq.ink is honest: it's automation, not a human expert. It's best for companies that currently publish nothing or very little — not for replacing a specialist content team producing thought leadership.

### "We already have a blog."
Great — bloq.ink connects to existing blogs. It adds content on top of what's already there. Articles are published to the client's own domain and repo. No migration needed.

### "We need brand voice."
Setup includes brand voice configuration. The agents are configured with the client's tone, audience, niche, and topic focus before the first article. The content plan is per-site and context-aware — it knows what the site is about and who the audience is.

### "What if Google penalizes AI content?"
Google has explicitly stated they care about quality and helpfulness, not how content was made. Their guidance: "Rewarding high-quality content, however it is produced." bloq.ink's multi-agent review loop and 22 quality checks are specifically designed to produce content that meets Google's quality standards.

### "We want to approve articles before they go live."
Configurable — auto-approve can be turned OFF. In manual mode, briefs are created as "pending" and require approval in the dashboard before the pipeline starts. Clients can review every brief and decide which topics to greenlight.

### "What about images?"
Articles include auto-generated OpenGraph images (for social sharing). In-article images use Next.js Image optimization with proper alt text. The system validates alt text quality as part of the 22 checks.

### "Can we edit articles after they're published?"
Yes — the content is in a GitHub repo. Clients can edit directly in GitHub, use their IDE, or request changes. The Article Refresh system won't overwrite manual edits to the core content (it only touches CTA buttons, styling, and internal links).

### "How fast does it start working?"
First article within 48 hours of setup. The pipeline runs daily after that. SEO results typically take 2–6 months (same as any content strategy). GEO results can be faster — AI engines update more frequently than Google's index.

---

## Affiliate Terms

- **Commission**: 35% of every payment the referred client makes
- **Duration**: lifetime — as long as the client is active, you earn
- **Tracking**: referral link (90-day cookie) + coupon code — both tracked independently
- **Coupon**: gives the client 20% off every invoice, forever
- **Payout**: monthly, $50 minimum, via PayPal / Wise / ACH / Crypto
- **Dashboard**: your referral stats are tracked at app.bloq.ink (you'll get access after registration)

### Earnings examples:

| Scenario                        | Client pays | You earn (35%) | Per year   |
|---------------------------------|-------------|----------------|------------|
| 1 client on Growth (monthly)    | $199/mo     | $69.65/mo      | $835.80/yr |
| 1 client on Growth (annual)     | $159/mo     | $55.65/mo      | $667.80/yr |
| 5 clients on Growth (monthly)   | $995/mo     | $348.25/mo     | $4,179/yr  |
| 3 Growth + 2 Scale (monthly)    | $1,395/mo   | $488.25/mo     | $5,859/yr  |
| 10 clients on Starter (monthly) | $990/mo     | $346.50/mo     | $4,158/yr  |

Note: with your 20% coupon applied, the client pays less but your commission is still 35% of what they actually pay.

| Scenario (with coupon)            | Client pays | You earn (35%) | Per year   |
|-----------------------------------|-------------|----------------|------------|
| 1 Growth client (coupon applied)  | $159/mo     | $55.65/mo      | $667.80/yr |
| 5 Growth clients (coupon applied) | $795/mo     | $278.25/mo     | $3,339/yr  |

---

## Suggested Angles for Promo Content

### Pain-first angles:
- "You haven't posted in 3 months. Your competitor posts weekly. Here's the fix."
- "I was spending $300/article on freelance writers. Now I pay $6.63/article."
- "My blog was dead for a year. Now it publishes 30 articles a month on autopilot."

### AI/tech angles:
- "Most SaaS companies are invisible to ChatGPT and Perplexity. This tool fixes that."
- "What is GEO and why it matters more than SEO in 2026"
- "I automated my entire content pipeline with AI agents — here's how"

### Comparison angles:
- "bloq.ink vs hiring a content writer — real cost breakdown"
- "bloq.ink vs Jasper vs Copy.ai — the difference is end-to-end automation"
- "Why I switched from [tool] to bloq.ink for content marketing"

### Founder/SaaS angles:
- "The content marketing tool I've been recommending to every founder I know"
- "How I'm getting SEO traffic without a content team"
- "30 articles/month for $199 — the ROI math on AI content"

### GEO-specific angles:
- "Google isn't the only search engine anymore — how to rank on ChatGPT"
- "AI search is eating Google. Here's how to get cited."
- "The tool that optimizes your content for BOTH Google and AI"

---

## Key Differentiators (What Makes bloq.ink Different)

### vs. AI writing tools (Jasper, Copy.ai, Writer):
Those tools help you write faster. **bloq.ink replaces the entire workflow** — research, writing, editing, review, publishing, monitoring. You don't touch anything after setup.

### vs. SEO tools (SurferSEO, Frase, Clearscope):
Those tools analyze content and suggest optimizations. **bloq.ink creates and publishes the content**, then optimizes it automatically. No manual intervention.

### vs. Content agencies:
Agencies cost $2,000–10,000/month and still require your time for briefs, feedback, and approvals. **bloq.ink is $99–399/month and runs autonomously.** Plus, you own the code — not locked in a CMS.

### vs. Doing nothing:
Every month without content = missed traffic, missed leads, missed AI citations. **Competitors who publish consistently will outrank you in both Google and AI.** Starting is more important than perfecting.

### Unique to bloq.ink:
1. **GEO built-in** — the only platform that optimizes for AI search engines alongside Google
2. **Multi-agent quality loops** — 5 review rounds + 22 automated checks, not just "generate and publish"
3. **Citation tracking** — weekly monitoring of 4 AI engines with gap analysis and content recommendations
4. **Zero lock-in** — content lives in a GitHub repo the client owns
5. **End-to-end automation** — from topic research to published article with zero human intervention
6. **Article refresh** — published articles stay current with design changes and new internal links

---

## Sample Audiences This Works Well For

- SaaS newsletter readers
- Startup and founder communities (Indie Hackers, HN, Product Hunt)
- Marketing Twitter / LinkedIn followers
- Agency owners and freelance marketers
- No-code and indie hacker communities
- DevTool and developer marketing people
- Anyone who has talked about content marketing, SEO, or organic traffic growth
- E-commerce operators looking for content-driven SEO

---

## Technical Details (For Technical Audiences)

If you're writing for a technical audience (developers, CTOs, DevTools), these details add credibility:

### Stack:
- **Pipeline**: BullMQ (13 job queues, Redis-backed) for reliable async processing
- **Blog**: Next.js with server-side rendering, deployed on Cloudflare Pages
- **Database**: PostgreSQL with Drizzle ORM
- **AI Models**: Gemini 2.5 Flash (fast/cheap), Claude Sonnet (quality editing), GPT-4o (citation tracking)
- **Git**: Every article is a real commit in a GitHub repo — full version history
- **Monitoring**: Google Search Console API, Google Indexing API, ChatGPT/Claude/Gemini/Perplexity APIs

### Architecture:
- Multi-agent pipeline with feedback loops (not a single prompt → publish flow)
- Deterministic article refresh (no LLM cost for style/CTA updates)
- Per-site isolation (each client has their own repo, config, API keys, budget)
- Custom migration system with rollback support
- Automatic conflict recovery for parallel publishes (git merge/rebase retry logic)

### Open/transparent:
- Content in GitHub (clients can see every commit, diff, and change)
- Quality scores visible in dashboard (not a black box)
- Cost tracking per agent per article (clients know exactly what they're paying for)
- RSS feed, sitemap, and `llms.txt` auto-generated

---

## Links

| Resource    | URL                         |
|-------------|-----------------------------|
| Website     | https://bloq.ink            |
| Pricing     | https://bloq.ink/pricing    |
| GEO page    | https://bloq.ink/geo        |
| Book a call | https://bloq.ink/book       |
| Free audit  | https://bloq.ink/#audit     |
| Affiliates  | https://bloq.ink/affiliates |

---

*Questions? Missing info? Email hi@bloq.ink — we'll answer and update this document.*