Clara — your SEO writing agent

Clara is PenGraph’s AI writing agent. On a schedule she researches, writes, and (in full autopilot) publishes SEO posts for your site — then learns from Search Console to improve the next ones.

You set brand voice, connect Google Search Console, turn Clara on, and intervene only when a quality gate fails or you pause.

Requirements

1. Site profile — brand voice and content goals configured.
2. Content roadmap (recommended) — Clara publishes the oldest planned roadmap topic first (lowest sequence_order), so the plan stays chronological. The roadmap holds at most 20 planned topics and is topped up automatically every morning.
3. Schedule — daily / weekly / monthly cadence (Roadmap → Clara / schedule).
4. Google Search Console connected — for the daily performance loop.
5. Site pull API (@pengraph/node or HTTP) — so published posts appear on your website.

Modes

Mode	Behaviour
Manual	You generate and publish. Clara stays off.
Drafts for review	Clara writes posts into review. You approve and publish.
Full autopilot	Clara writes from the roadmap; if fact-check confidence ≥ gate (default 0.25) and Clara is not paused → auto-publish. Posts with no verifiable claims still publish, and real gate failures stay in review and are logged.

Kill switch: Pause Clara anytime. Auto-publish, auto-apply of quick wins, and the daily roadmap top-up all stop while paused (the existing queue is kept).

Let Clara fix it

Most cards on What to do next are about articles Clara manages, so you shouldn't have to fix them by hand. Cards that don't already have their own button (for example Clara's strategy cards) show Let Clara fix this:

1. Click Let Clara fix this. Clara reads the card and your articles and writes a plan. Nothing changes yet.
2. The window shows exactly what she will do (for example "Combine 6 similar articles into …, then archive those 5"), what will change on your live website (old addresses that will forward), and anything only you can do (a hosting or Google setting).
3. The window also shows what the fix costs in credits and how many you have. Click Approve · N credits, or Ask for a different plan.
4. Clara works in the background. Rewriting an article takes a few minutes each. The card shows each step as it finishes, and you can leave the page.
5. When she's done, the card lists what she did and what's left for you, if anything.

Fix several cards at once

1. Tick the box on each card you want Clara to fix, or click Select everything Clara can do.
2. A bar at the bottom shows how many you picked, what they cost and how many credits you have.
3. Click Let Clara fix N. The window lists each card with its price ("≈" means the usual price; the exact price is set once Clara plans it, and small fixes often cost less).
4. If any card is about duplicate articles, tick Let Clara merge or retire articles to let her do it without asking again. Leave it unticked and she plans those cards, then waits for your OK.
5. Click Start in the background. Clara works through the cards one at a time. Each card shows "In Clara's queue", then her progress, then the result. You can close the page.

If your credits (or today's limit) run out part-way, she stops there. The cards she didn't start say so and keep their steps, so you can fix them yourself or buy more credits and pick them again.

What Clara can do on her own: merge duplicate articles (and forward the old addresses), rewrite an article, change titles and Google descriptions, describe pictures in an article, archive an article, add a redirect, tell search engines about changes, and correct the addresses SEOcondo has stored for your articles.

Pictures without a description ("Images missing alt text"): if the pictures are in the article, Clara adds a short description to each for 1 credit. If they're part of your website's design (an author photo, the small pictures next to related articles), she can't change them from SEOcondo, so the card gives you a short note to send to whoever looks after your website. Decorative pictures marked alt="" are fine and aren't flagged.

Merging needs redirects on your website

When articles are merged, their old addresses must forward to the kept article. If your website loads articles from SEOcondo's Site API, ask your developer to apply SEOcondo's redirects (see moved articles); otherwise the old addresses show "page not found".

What Clara fixes on her own

On Full autopilot, every morning Clara works through What to do next by herself:

• Cards about one article (a stale post, a weak title, two articles competing for the same search) and her own strategy cards (duplicate topics, wrong addresses). She plans the fix and carries it out.
• Anything that removes or merges articles waits for you. The card says "Clara has a fix ready and needs your OK"; click Review and approve.
• Anything only you can do (hosting, DNS, Google or Bing settings) stays on the card as your steps.

How much she does is set by your credits. Every fix she runs on her own is paid for in credits, just like one you click. Autopilot may spend up to 70% of your plan's monthly credits by herself, within your daily limit, and never your extra credits, so there is always room for the work you pick. When she reaches that share or today's limit, she pauses her own fixes and says so in the log; the rest waits until the limit resets.

Clara credits and usage limits

Everything Clara does with AI uses credits: writing articles, answering in chat, and Let Clara fix (including Improve post and everything she fixes on autopilot). Syncing your data, reports and the daily checks don't use credits.

What things cost

What Clara does	Credits
Write a new article	10
Answer a question in chat	from 1 (more when she has to look a lot up)
Rewrite an article (also Improve post)	15
Merge articles into one	25
Change a title or Google description	1
Describe the pictures in an article	1
Retire an article, add a redirect, tell search engines, fix stored addresses	Free

You see the price before anything runs: on each card, in the fix window, and in the selection bar. Credits are taken when the work starts, and if an article or a step fails, its credits come back automatically.

Your usage limits

Like Claude's own usage limits, your plan gives Clara two limits, each shown as a bar with the time it resets. Open the menu under your name (bottom left) to see them at any time, or Clara → Usage for the full page.

Plan	Daily limit	Monthly limit
Free trial	30	60
Basic	50	200
Pro	150	650
Agency	400	1,600

• Daily limit: resets every night at midnight UTC (1:00 AM in Lagos). It stops one busy day, like fixing 25 cards at once, from using the whole month.
• Monthly limit: your plan's credits for the month. They arrive on the 1st; unused ones don't carry over.
• Credits belong to your account, so all your brands share them.

Extra credits: when a limit runs out, credits you buy keep Clara working. Open Clara → Usage and choose a pack (100, 300 or 1,000 credits). It's a one-off payment, not a subscription, and extra credits never expire. Clara only uses them after your plan's limits, and autopilot never uses them: they're for the work you ask for.

Out of credits? Nothing breaks. Every card still has its steps, so you can fix it yourself. Scheduled articles wait until the limit resets, and the activity log says so.

Clara learns from her fixes

Every time Clara fixes a mistake in her own articles, she writes down the rule that would have prevented it (for example "Before writing, check that no existing article already covers the topic"). She follows those writing lessons on every new article and rewrite, so the same mistake isn't written, and paid for, twice.

• See them in Clara → Configuration → Lessons Clara learned, right under your Standing instructions. You can edit or delete any lesson; an edited one is kept as you wrote it.
• Your own rules for Clara go in Standing instructions (one place for what you want; lessons are what she taught herself).
• Before writing a planned article, Clara also checks it against everything you've published. If the topic is already covered, she skips it (no tokens spent) and notes it in the log.

Working now

Clara → Working now shows everything Clara does in the background, so nothing happens out of sight:

• Right now: what she's working on this minute, with progress.
• Waiting for your OK: fixes she planned that merge or archive articles.
• Credits: how many you have left, and how much of autopilot's share she has used this month.
• Up next: cards she'll fix at the next morning run and the next articles she'll write.
• When Clara works: each routine in plain words and when it runs next.
• Just done: her latest actions, marked "on her own" when she did them without being asked. The full history stays on Logs.

Long tasks run in the background

Improve post and Let Clara fix this rewrite articles with the full writing process, which takes a few minutes. They run on the server, not in your browser:

• The button answers straight away and the card shows Clara is working on it with live progress.
• You can close the page or your laptop; the card updates by itself when it's done.
• If something goes wrong, the card says what happened and offers Try again. If the server restarts mid-task, the card notices after 30 minutes and offers Try again; nothing is half-published.

Your recipes, products and services in articles

Clara links your own recipes, products, services, courses or menu items from her articles, so readers land on the pages that matter to your business, not only on other articles.

How it works

1. Clara reads your sitemap every night and finds the pages that are things you offer: recipes, products, services, courses, events, menu items. She recognises them from the structured data search engines already read on those pages, or from addresses like /recipe/… or /products/…. She doesn't use AI for this, so it costs no credits.
2. For each article, she picks the ones that fit. An article about egusi soup gets your egusi recipes; a "quick dinners" article gets your quick recipes. A broad article (like a weekly meal plan) gets a few examples. Items linked less often are favoured, so links spread across your whole catalog.
3. She links them by name in the part of the article where they help, or in a short "Recipes to try" list near the end. She only ever links pages that exist on your site.

Where to find it: open your brand, then Website in the menu (or Brand settings → Your recipes & products → Open).

Setting	What it does
Feature my recipes/products in new articles	On by default. Turn it off and Clara stops adding them.
Up to … per article	How many she may link in one article (1–6, default 3). These come on top of the usual 2–4 links to your other pages.
Pin	Always mention this one whenever it fits the article.
Hide	Never link this one.
Scan site now	Read your sitemap straight away instead of waiting for the night. A large catalog is read 150 pages at a time.

Add links to articles you've already published

On the same card, Add links to … articles goes through your published articles and links the items that fit each one. This is not a rewrite: Clara keeps your article as it is and only turns a matching phrase into a link, or adds one short sentence. Items she can't place go into a short list before the FAQ or conclusion.

It costs 1 credit per article that gets links (articles with nothing to add are free), and you get the credit back if something goes wrong. It stops if you run out of credits; run it again later for the rest. Search engines are told about the updated articles automatically.

Nothing found? Check that your sitemap lists your recipe or product pages. Clara can only link pages your sitemap publishes.

Standing notes & reference URLs

In Clara settings you can optionally set:

• Standing notes — persistent instructions applied on every Clara post (angles, must-mentions, avoidances). Brand profile + GSC/roadmap still choose the topic.
• Reference URLs — pages she always fetches for facts (same behaviour as Generate’s reference links, but reused every run).

Daily performance loop

Clara’s performance loop (server job, secured with CRON_SECRET):

1. Sync GSC metrics for every connected site.
2. Generate recommendations (e.g. quick wins for positions 5–20).
3. On full autopilot: auto-execute up to 2 quick wins per week.
4. Seed preferred keywords from new-topic opportunities for the next writing run.
5. At 06:30 UTC, refresh each active roadmap: new topics (informed by those GSC seeds) are appended at the back of the queue, and the queue is capped at 20 planned topics. The job generates only the slots that are free, so a full roadmap costs nothing.

Roadmap order

Clara is a plan-follower, not an idea generator:

• She picks the lowest sequence_order planned topic — the oldest one in the roadmap.
• "Add 10 topics", the daily refresh, and recommendation seeds all append to the back, so new ideas can never jump ahead of queued topics.
• If the roadmap is empty she falls back to keyword research (this is also how Manual mode's Generate button works: the AI picks a fresh topic from your site profile).

To reorder, update a topic's sequence_order (API PATCH /api/roadmap/:id) or remove it; the cap of 20 planned topics is enforced on every path.

Quality gates

Auto-publish only when:

• Mode is full autopilot
• Clara is not paused
• Pipeline completed with fact_check_report.overallConfidence ≥ autopilot_min_factcheck (default 0.25)

Otherwise the post stays in review.

Activity log

Roadmap → Clara panel shows recent activity (generate, auto-publish, gate failures, GSC sync, recommendation execution).

Operator checklist

1. Open Dashboard → site → Content Roadmap.
2. Generate a roadmap (or keep an existing plan).
3. Set when Clara writes (day/time/timezone) and choose a mode.
4. Connect Search Console on the Visible everywhere → Google tab.
5. Create a Site API key and pull published posts on your site.
6. Watch the activity log; pause Clara if something looks wrong.