Getting started

A SEOMANTIK subscription is two things working together: the skills, which run inside Claude Code and do the work, and the SEOMANTIK feed, which gives them live search data. You type one line in a Claude Code session; the skill plans, measures and writes, and everything it produces stays in a folder on your computer.

This page covers setup, the connection check, your allowance and what to do when something goes wrong. Each skill has its own page:

• The planner (seomantik-topic): turns your domain and a seed keyword into a complete build plan.
• The writer (seomantik-content): turns one page of that plan into a published article with its sources.
• The link builder: its own plan. seomantik-finder finds and ranks every site that could link to an article, and seomantik-outreach drafts the pitches.
• Ask the feed directly: questions you can ask the feed without running a skill.

Set it up

There are two ways. Pick one.

The project folder (recommended)

1. Open your dashboard and download your project folder.
2. Unzip it anywhere on your computer.
3. Open it:
   • Claude desktop app: open the folder, go to the Code tab and start a session.
   • Terminal: open a terminal in the folder and run claude.

The folder already holds your skills and the connection to the feed, with your key in place. Nothing else installs.

Connect the feed once, for every folder

If you would rather use the skills in folders of your own, connect the feed once from a terminal. The command with your key filled in is on your dashboard; it has this shape:

claude mcp add --scope user --transport http seomantik-feed <feed url> -H "X-Seomantik-Key: <your key>"

Then copy the skills from the downloaded folder's .claude/skills/ into the .claude/skills/ folder of the project you want to work in.

Check the connection

Claude may ask once to approve this project's servers. If it does, approve seomantik-feed. Some setups enable it without asking, so the prompt is not the check.

The check is /mcp. Type it in the session: seomantik-feed must be listed as connected. If it is not, see "When something goes wrong" below.

Every skill run then starts by telling you where you stand, in one line: the sites open on your subscription, the briefs left this period, the data used this period and the date everything resets.

Your allowance

A planner and writer subscription gives you three things: sites, briefs and data. Each is counted differently. A link builder plan counts runs and pitches instead; see The link builder.

Sites

A site is a domain you work on, like yourdomain.com. A site opens the first time a skill runs on it and stays open for good: resuming, re-running and re-reading it are free, this period and every period after. The number of sites does not reset; a bigger plan raises it.

A second market for the same site (the United States, then Canada) or a second seed keyword for it uses the same open site. Neither takes a second one.

Briefs

One page written is one brief. A brief is used when the writer starts a page from your plan. These never use a brief: the plan itself, internal links, redirects, merges, reviews, and resuming or rewriting a page already started.

Briefs reset every 30 days, counted from the day you subscribed. They are shared across all your sites.

Data used

Every question the feed answers uses a little of your data allowance: building a plan, the monthly progress pass, and any question you ask the feed directly. Sites and briefs do not use it. It is shown as a percentage of this period's allowance, and it resets with your briefs.

Normal work on your sites stays well inside it. Asking the same question twice within a few minutes is answered from memory and uses nothing.

Where you see it

• On your dashboard: sites open, briefs used this period, data used this period and the reset date.
• On the first line of every skill run.
• At any time, by asking in a session: "What is left on my SEOMANTIK subscription?"

Updates

The skills improve between releases. When a newer edition is available, the first lines of a run say so. To update:

1. Download your project folder again from the dashboard.
2. Replace the .claude/skills folder in your existing project with the new one.

Your data/ folder, your plan and your pages stay exactly as they are. An older edition keeps working in the meantime; nothing stops mid-run because of it.

Keep your key private

Your key is in .mcp.json in the project folder, or in Claude Code's own settings if you connected the feed from a terminal. Anyone holding the key uses your allowance.

• Do not share the folder or publish it.
• If you put the project in git, .mcp.json is already listed in .gitignore.
• If the key leaks, email contact@seomantik.com and it is replaced.

When something goes wrong

seomantik-feed is not listed in /mcp, or not connected. Close the session and start a new one in the same folder. If you used the terminal command, run claude mcp list to confirm it was added. If it still does not connect, check that your subscription is active on the dashboard.

"No site is open on this subscription yet." The skill tried to fetch data before opening your site. Start the run with your domain in the first line, for example:

Run seomantik-topic on yourdomain.com with the seed keyword "your main keyword"

"Site allowance reached." Every site on your plan is in use. The message lists them. Work on one of those, or move to a bigger plan; the new allowance applies to the same key straight away.

"This period's briefs are all released." Your plan and everything written so far stay on disk. New pages continue on the reset date the message gives, or straight away on a bigger plan.

"This subscription has reached its data ceiling for this period." This does not happen in normal work on your sites. It resets on the date the message gives. If you reached it doing real work, write to us or move to a bigger plan.

The session ended in the middle of a run. Nothing is lost. Open a new session in the same folder and paste the sentence the run printed at its last step, or simply type your first line again: the skill finds where it stopped and continues without paying twice for anything already done.

"A newer edition of this skill is on your subscription." See Updates above. The run continues on the edition you have.

The first line shows sites or a reset date you do not recognise. The session is using a different key, usually an older project folder or an earlier terminal connection. Check /mcp and the folder you opened.

Your account and billing

Your dashboard holds your key, the folder download, your sites, your usage this period and billing. Manage billing opens the billing portal: invoices, your payment method, changing plan and cancelling.

If you cancel, every file the skills produced stays yours. The feed stops at the end of the period you paid for.

Support

Email contact@seomantik.com. Include the first line your last run printed; it tells us exactly where your subscription stands.