Back to home

Semsei Docs

Semsei Platform documentation

Step-by-step product documentation for setting up brand context, generating pages with AI, connecting domains, publishing to CMSs, and fixing common issues.

New guide: start with brand and sources before generating pages. This order prevents most content and publishing mistakes.

01 · Workspace foundation

Getting started

Start with the right workspace. In Semsei, a workspace groups brand, sources, domains, integrations, and generated pages.

Step by step

  1. 1

    Create your account or open the dashboard if you are already signed in.

  2. 2

    Go to Pages or Domains and create a project if no workspace exists.

  3. 3

    Name the project after the brand or site you want to rank.

  4. 4

    Before generating content, configure brand, search sources, and generation defaults.

Checklist before continuing

  • ✓Use one workspace per brand or main domain.
  • ✓Review billing limits before bulk generation.

02 · AI context

How to configure your brand manual

Brand setup is essential: Semsei injects it into prompts so generated pages follow voice, links, authorship, colors, and restrictions.

What the AI reads from your brand

Semsei uses name, primary site, logo, palette, fonts, tone, audience, manual, authorial stance, and prohibitions as generation context.

Step by step

  1. 1

    Open Settings and select the correct workspace.

  2. 2

    Complete brand name, tagline, primary website, and logo URL.

  3. 3

    Set colors, link colors, button colors, and typography when the content needs branded rendering.

  4. 4

    Write tone of voice, target audience, authorial stance, and content prohibitions.

  5. 5

    Upload the brand manual and run Analyze manual to extract rules automatically.

  6. 6

    Save and confirm the primary website is the real CTA/internal-link destination.

Checklist before continuing

  • ✓The primary website is correct.
  • ✓Prohibitions describe what the AI must not assume.

Where users get lost

  • !Uploading a manual but not analyzing it.
  • !Leaving the brand voice as generic adjectives.

03 · Market references

Search sources and reference sites

Sources tell Semsei which domains to prioritize for niche context, style, and facts.

Step by step

  1. 1

    Open Settings, choose a workspace, and go to Sources.

  2. 2

    Add name, URL, and category.

  3. 3

    Use competitors, official sources, and high-quality industry blogs.

Checklist before continuing

  • ✓Each source uses a public https:// URL.
  • ✓Only keep sources you actually want Semsei to learn from.

04 · Defaults

Generation defaults

Defaults reduce repeated mistakes when generating pages in bulk.

Step by step

  1. 1

    Choose layout: classic, modern, or card.

  2. 2

    Choose language: Spanish, English, or both.

  3. 3

    Enable search sources when configured.

  4. 4

    Enable auto-publish only after integrations are tested.

Checklist before continuing

  • ✓Language matches the target market.
  • ✓Auto-publish is off while reviewing content manually.

05 · Content generation

Create pages with AI

AI generation creates SEO pages from a topic, quantity, workspace, integration, language, and defaults.

Step by step

  1. 1

    Open Pages and choose Generate with AI.

  2. 2

    Write a clear topic with product, audience, country, or search intent.

  3. 3

    Start with 1 or 5 pages, then scale once the flow is validated.

  4. 4

    Choose workspace and destination integration when publishing to WordPress or Shopify.

Checklist before continuing

  • ✓The workspace has brand context saved.
  • ✓Billing limits allow the requested quantity.

06 · Editorial review

Edit and review pages

Review title, slug, content, FAQ, images, Shopify metadata, and consulted sources before publishing.

Step by step

  1. 1

    Open Pages and filter by project or status.

  2. 2

    Edit the page.

  3. 3

    Validate title and slug.

  4. 4

    Review body, FAQ, image, and sources.

  5. 5

    For Shopify, set blog, author, excerpt, tags, and template suffix.

Checklist before continuing

  • ✓Slug is readable and unique.
  • ✓FAQ answers real questions.

07 · Technical SEO

Connect a domain and Google Search Console

Custom domains publish pages under the host you want to rank and let Semsei submit sitemaps.

Where users get lost

Most failures come from the wrong DNS host, missing GSC permissions, or submitting sitemap before DNS is verified.

Step by step

  1. 1

    Open Domains, select the project, and enter the domain.

  2. 2

    Choose DNS provider.

  3. 3

    Create the DNS record Semsei gives you.

  4. 4

    Verify status until the domain is verified.

  5. 5

    Invite semsei@semsei-497915.iam.gserviceaccount.com in Google Search Console.

  6. 6

    Submit sitemap and review 28-day Search Analytics.

Checklist before continuing

  • ✓The DNS record is in the correct zone.
  • ✓Google Search Console includes the Semsei service account.

08 · CMS

WordPress integration

WordPress uses the REST API and a WordPress Application Password to create posts from Semsei.

Step by step

  1. 1

    Create an Application Password for the publishing user in WordPress.

  2. 2

    Open Semsei Integrations and choose WordPress.

  3. 3

    Enter site URL, username, and Application Password.

  4. 4

    Connect and verify the site appears as connected.

  5. 5

    Generate or edit a page and publish to WordPress.

Checklist before continuing

  • ✓The URL is the public WordPress site, not /wp-admin.
  • ✓The user can create posts.

Where users get lost

  • !Using the regular account password instead of Application Password.
  • !REST API blocked by security plugins.

09 · Commerce

Shopify integration

Shopify connects through OAuth/plugin and API keys to publish articles into the correct store blog.

Step by step

  1. 1

    Open Shopify integration and select a workspace.

  2. 2

    Connect the store via OAuth or configure the plugin with the generated API key.

  3. 3

    Copy the API key when shown; it appears once.

  4. 4

    Verify store connected status.

  5. 5

    Choose blog, author, excerpt, tags, and template suffix before publishing.

Checklist before continuing

  • ✓The connected store matches the active workspace.
  • ✓At least one Shopify blog is available.

Where users get lost

  • !Losing the API key requires generating a new one.
  • !Missing permissions can prevent loading blogs or publishing.

10 · Production

Publishing and previews

A page can live in Semsei, render as preview, publish to a custom domain, or be sent to WordPress/Shopify.

Step by step

  1. 1

    Use preview for internal review.

  2. 2

    Publish to a custom domain after DNS verification.

  3. 3

    Publish to WordPress or Shopify after the integration is tested.

  4. 4

    Validate final URL, canonical, sitemap, and schema.

Checklist before continuing

  • ✓The final URL belongs to the domain you want to rank.
  • ✓Canonical does not point to localhost, app-qa, or preview.

11 · Diagnosis

Troubleshooting

Find the symptom, check the likely cause, and correct the minimum configuration.

Step by step

  1. 1

    Google is not indexing: check robots, canonical, sitemap, internal links, and Search Console.

  2. 2

    Domain does not verify: check DNS host, TXT/CNAME value, and provider.

  3. 3

    WordPress fails: verify Application Password, user, REST API, and plugins.

  4. 4

    Shopify fails: check OAuth, API key, permissions, blogs, and connected store.

  5. 5

    AI sounds off-brand: review brand manual, tone, prohibitions, and sources.

Checklist before continuing

  • ✓Change one variable at a time.
  • ✓Retry publishing or sitemap submission after the fix.

12 · Quick answers

FAQ

Short answers for setup, generation, publishing, and indexing decisions.

Step by step

  1. 1

    Configure brand, sources, and defaults before generation.

  2. 2

    Connect the domain before publishing pages you want indexed.

  3. 3

    Use CSV when you need external editorial review.

  4. 4

    If content is generic, improve brand manual, tone, and sources.