# Synscribe Playbook

## Docs

- [How-to library](https://docs.synscribe.com/how-to.md): Every task for running your SEO on Synscribe, as a short how-to you can browse by task.
- [Synscribe Training & Playbook](https://docs.synscribe.com/index.md): How to run your SEO on Synscribe with Pi, your AI agent: the typical workflow, and how to get it to plan, write, publish, and report.
- [An Opinionated Guide](https://docs.synscribe.com/opinionated-guide.md): The step-by-step way we'd run SEO on Synscribe, in order: set up, find keywords, build pages, write, publish, grow, and review.
- [How to update landing pages by editing the pillar prompt](https://docs.synscribe.com/platform/align-pillar-prompt.md): Adjust a pillar's generation prompt to fold in the changes you want.
- [How to set up conversion attribution](https://docs.synscribe.com/platform/attribution-setup.md): Wire attribution into the page — a user-journey trace on the lead form, a dual contact form, and pillar-level conversion tracking — so every conversion can be traced back to a pillar.
- [How to automate compliance and quality checks for your content](https://docs.synscribe.com/platform/automate-compliance-checks.md): The compliance guardrail is an AI reviewer that checks every piece against your rules and blocks a publish that breaches one, so nothing off-limits goes live.
- [How to turn a sales call or shower thought into a blog post](https://docs.synscribe.com/platform/blog-ideas-from-conversations.md): Turn a customer question, a call, or a stray idea into a drafted post: tell Pi, bring your own angle, or paste a sales transcript.
- [How to turn keywords into blog post ideas](https://docs.synscribe.com/platform/blog-ideas-from-keywords.md): Turn keywords from your research into blog posts: select them, generate SERP-analyzed ideas, shortlist, write, and track the ranking.
- [How to use Reddit to generate blog post ideas](https://docs.synscribe.com/platform/blog-ideas-from-reddit.md): Turn Reddit discussions into top-of-funnel blog topics: find where your ICP posts, run a discussion report, and write from real community language.
- [How to bring your own DataForSEO key (run SERP data on your own account)](https://docs.synscribe.com/platform/byok-dataforseo.md): Connect your own DataForSEO API login and password so live Google SERP data — the data behind keyword exploration and SERP-cliff analysis — runs on your own DataForSEO account instead of Synscribe's shared one.
- [How to calibrate the compliance guardrail (test it before you trust it)](https://docs.synscribe.com/platform/calibrate-evaluator.md): Run the compliance judge on copy you know should fail and copy you know should pass, then tighten the rules until it gets both right.
- [How to research your company and build the Product Bible](https://docs.synscribe.com/platform/company-research-product-bible.md): Run company-explorer and product-bible to turn ICP knowledge into your account's source of truth.
- [How to set up Synscribe for compliance and quality control](https://docs.synscribe.com/platform/compliant-content-regulated-industry.md): Where compliance and quality actually get controlled in Synscribe — five layers, from what Pi knows about you to the gate at publish, set up in order.
- [How to connect Google Search Console](https://docs.synscribe.com/platform/connect-gsc.md): OAuth-connect your Google Search Console and pick the verified property on the Features tab under Settings.
- [How to connect PostHog or Mixpanel](https://docs.synscribe.com/platform/connect-posthog-mixpanel.md): Connect your product analytics on the Features tab under Settings, PostHog via OAuth or Mixpanel via credentials.
- [How to set up Pi for your business](https://docs.synscribe.com/platform/create-org-init-pi.md): Set Pi up in one short conversation — tell it what you do, and it names itself, learns your account, and seeds the files it reads on every chat.
- [Creating blogs](https://docs.synscribe.com/platform/creating-blogs.md): The map of blog creation on Synscribe: three ways to generate ideas, the setup that makes drafts sound like you, and publishing.
- [How to design a landing-page pillar](https://docs.synscribe.com/platform/design-landing-page-pillar.md): Define a whole type of landing page (a schema plus a generation prompt) for programmatic scale.
- [How to drive Pi Agent well](https://docs.synscribe.com/platform/driving-pi-well.md): Hand Pi whole tasks, tell it to check its plan before acting, and clear its blocks in the Agent Inbox.
- [How to edit an AI-generated article](https://docs.synscribe.com/platform/edit-articles.md): Three ways to edit a draft on Synscribe (a refiner, by hand, or an AI edit), plus Pi, each stored as a layer you can review and undo.
- [How to check if you can rank for a keyword](https://docs.synscribe.com/platform/evaluate-serp-cliff.md): Quality-gate a batch of candidate keywords with keyword-evaluation and serp-cliff-analysis, the ACCEPT / REVIEW / REJECT "can I win?" gate.
- [How to export a landing-page pillar to your site](https://docs.synscribe.com/platform/export-pillar-wire-to-site.md): Get pillar data out of Synscribe and onto your website.
- [Not working? File a report](https://docs.synscribe.com/platform/file-a-report.md): Ask Pi to file a report right from the chat — it sends the team the full context so we can fix it sooner.
- [How does Pi work with files](https://docs.synscribe.com/platform/filing-in-the-vfs.md): Pi keeps its own private notes about your account. Say "save this to memory" and it files your research and decisions so later chats recall them.
- [How to fix a page that won't rank (or a ranking drop)](https://docs.synscribe.com/platform/fix-page-not-ranking.md): Diagnose an underperforming page, keyword, or cluster by asking Pi to run the seo-debug skill — a structured observation, hypothesis, evidence, diagnosis walk that avoids defaulting to "must be backlinks" and writes a persistent report.
- [How to generate landing pages from a pillar](https://docs.synscribe.com/platform/generate-landing-pages.md): Produce landing pages from a pillar, reading the SERP and your existing pages.
- [How to get cited by AI answer engines (turn a research trace into keywords)](https://docs.synscribe.com/platform/get-cited-by-ai.md): Use the fanout-content-mining skill to turn an LLM's research trace — the fan-out queries it fired and the pages it read — into keywords and content angles optimized to be cited by AI answer engines, read through a similarity lens and a gap lens.
- [How to prepare a guest-post article](https://docs.synscribe.com/platform/guest-post-articles.md): Edit and prep an article for publishing on someone else's site.
- [How does the compliance guardrail decide pass or fail?](https://docs.synscribe.com/platform/how-evaluator-decides.md): A policy is org context plus rules; a single judge reads the content and returns violations; one confirmed violation fails.
- [How to handle an inbound link-exchange proposal](https://docs.synscribe.com/platform/inbound-link-exchange.md): Evaluate and respond to an inbound link-exchange / link-insertion offer.
- [How to get your blog post indexed on Google fast](https://docs.synscribe.com/platform/index-gsc-sitemap.md): The fastest way to get a new page on Google (usually 12–24h): URL Inspection in Search Console, then Request Indexing.
- [Keyword evaluation vs SERP-cliff analysis: what's the difference?](https://docs.synscribe.com/platform/keyword-eval-vs-serp-cliff.md): Keyword evaluation is the full batch quality gate (a 5-dimension rubric, cannibalization gate, and ACCEPT/REVIEW/REJECT verdicts); SERP-cliff analysis is just the winnability lens inside it, run as a quick check on a small keyword cluster.
- [How to find keyword opportunities](https://docs.synscribe.com/platform/keyword-exploration.md): Discover candidate keywords with the keyword-exploration skill (DataForSEO, Ahrefs, web research), starting from BOFU seeds.
- [How to run compliance edits across landing pages (LP refiners)](https://docs.synscribe.com/platform/landing-page-refiners.md): Apply reusable, schema-safe edits across many landing pages at once — compliance fixes included — and revert them safely.
- [How to kick off a link-building campaign from a search term](https://docs.synscribe.com/platform/link-building-kickoff.md): Start an outreach push to build backlinks to a page, driven from a search term.
- [How to build a monthly keyword plan](https://docs.synscribe.com/platform/monthly-keyword-report.md): Turn the tagged keyword inventory into a monthly look-ahead report that plans the cycle: what to build, in what order, and why.
- [How to organise and tag keywords in Synscribe](https://docs.synscribe.com/platform/organise-tag-file-keywords.md): Load accepted keywords into the Keywords dashboard, apply intent/relevance labels and cycle tags, and file the supporting research to notes.
- [How to build an SEO performance review from GSC + PostHog](https://docs.synscribe.com/platform/performance-review.md): Join what ranks (GSC) with what converts (PostHog) into one performance review — striking-distance, cannibalization, and AI-referral traffic, per pillar.
- [How to set up a PostHog dashboard for content analytics](https://docs.synscribe.com/platform/posthog-dashboard-setup.md): Provision the standard PostHog views — session recording, conversion actions, the Pages-with-AI-Traffic insight, and the sitewide + per-pillar conversion funnels.
- [How to use a press release for an SEO bump](https://docs.synscribe.com/platform/press-release.md): Use a press release to nudge rankings for a page at the right moment.
- [How to publish a page and set its live URL](https://docs.synscribe.com/platform/publish-set-live-url.md): Ship a finished piece from the article's Publishing tab and record where it went live so the rest of the workflow can see it.
- [How to publish your blog with the right metadata](https://docs.synscribe.com/platform/publish-your-blog.md): Copy a finished post into your CMS, pick the right slug and description, and publish by hand or through a platform integration.
- [How to set up a publishing platform and IndexNow](https://docs.synscribe.com/platform/publishing-platform-indexnow.md): Configure the publishing destination (Platforms tab under Settings) and turn on IndexNow (Features tab under Settings).
- [Refiner vs guardrail: what's the difference?](https://docs.synscribe.com/platform/refiner-vs-evaluator.md): Two systems that both touch compliance but do opposite jobs — a refiner rewrites content to fix it, the guardrail judges it pass or fail — and the refiner runs first.
- [How to register for a Synscribe account](https://docs.synscribe.com/platform/register-account.md): Sign in at synscribe.com/app with your work Google account or a magic link, then have the Synscribe team add you to your organization.
- [How to set up the compliance guardrail](https://docs.synscribe.com/platform/set-up-evaluator.md): Write a compliance policy — org context plus a few atomic rules — and turn it on per content type.
- [How to set up image generators for on-brand blog images](https://docs.synscribe.com/platform/set-up-image-generators.md): Set up a branded image generator once so every blog post gets on-brand featured, OG, and CTA images.
- [How to set up refiners for your content](https://docs.synscribe.com/platform/set-up-refiners.md): Set up your default post-production refiners once so every post gets a TLDR, FAQ, product alignment, and CTA banner.
- [How to run a technical SEO audit](https://docs.synscribe.com/platform/technical-seo-audit.md): Audit a published page against the checklist before you count it as done.
- [How to turn a video into a landing page](https://docs.synscribe.com/platform/video-to-landing-page.md): Turn a product/feature video into a vertical (feature) landing page.
- [What is Pi Agent](https://docs.synscribe.com/platform/what-is-pi-agent.md): Pi is your account's own AI agent for marketing and SEO: it plans, researches, writes, publishes, and reports, using your connected data, while you steer and approve.
- [How an AI Agent Changes the Way SEO Runs](https://docs.synscribe.com/theory/agent-operated-seo.md): SEO here is operated through an AI agent (Pi) rather than a human clicking tools; you give a task, the agent fans out the work with subagents, and its knowledge compounds in a durable VFS.
- [Attribution for AI Traffic and Pillar Pages](https://docs.synscribe.com/theory/attribution.md): We attribute to business outcomes at the pillar level and to AI-answer-engine traffic, never to rankings or impressions as ends in themselves.
- [Why We Start With Bottom-of-Funnel Keywords](https://docs.synscribe.com/theory/bofu-first.md): One keyword maps to one page, and we build bottom-of-funnel first then work up, the opposite of the classic awareness-blog playbook.
- [Our Definition of Done](https://docs.synscribe.com/theory/definition-of-done.md): Quality is a hard gate at every phase, phrased as yes/no questions from the ICP's point of view, including a claims-safety gate you clear before publishing.
- [How to Tell If You're Heading in the Right Direction](https://docs.synscribe.com/theory/early-signs-of-traction.md): The early signs your SEO is working arrive as a ladder of leading signals, indexing then AI citations then multi-keyword ranking, weeks before conversions show up.
- [How We Approach SEO, GEO & Agentic Discovery](https://docs.synscribe.com/theory/index.md): The model behind the guides: why Pi researches, writes, and publishes the way it does.
- [Search Intent and Keyword Cannibalization](https://docs.synscribe.com/theory/intent-cannibalization.md): One page targets exactly one intent with one keyword, and your own pages must never compete for the same intent. A 2-D framework decides what survives.
- [Internal Linking and Site Authority](https://docs.synscribe.com/theory/internal-linking-authority.md): Internal linking is the authority-distribution mechanism that makes a programmatic pillar rank, and the subtle failure is hiding link lists in JS so they leave the DOM and stop counting.
- [Horizontal and Vertical Landing-Page Pillars](https://docs.synscribe.com/theory/landing-page-pillars.md): Landing pages come in exactly two shapes that create two different feelings in the ICP, and you go wide before deep, generating each pillar programmatically from a template plus data.
- [Link Building and Press Coverage](https://docs.synscribe.com/theory/off-page-link-building-press.md): Off-page is a timed bump (a press push to nudge rankings at the right moment), and outreach is an always-on setting you turn on day one, sequenced after the pages exist.
- [Reading the SERP Cliff Before You Pick a Keyword](https://docs.synscribe.com/theory/serp-cliff.md): Before writing anything, we gate keywords on winnability (a visible SERP cliff) and drop the ones we can't win, even high-volume ones. We pick on winnability, not volume.
- [Getting a New Domain to Rank Quickly](https://docs.synscribe.com/theory/speed-to-rank.md): A brand-new domain can put 5–10 pages into positions 1–5 within ~2 weeks, because speed is a design choice you engineer from BOFU, long-tail, a verified cliff, and exact-match titles.
- [Programmatic SEO and GEO for SaaS](https://docs.synscribe.com/theory/thesis.md): We win by manufacturing many small, winnable, high-intent pages instead of chasing volume on head terms, and the real moat is ICP knowledge.
- [Ranking on Both Google and AI Answer Engines](https://docs.synscribe.com/theory/two-search-surfaces.md): Search runs in three eras at once, and the newest ones fan one task into many queries, so the game is to be citable across the fan-out rather than ranked first for a single phrase.