Claude Code workspace for a project
One folder that gives Claude Code your SEO system: rules, client facts, goals, methods, live data and a log of what was done, so you stop repeating yourself in every conversation.
About 4 minutes
What you need
- A project in Searvia
- For the terminal: Node.js and a Searvia API key (API & MCP)
- 1
Download it, or create it from the terminal
Settings › API & MCP
On the API & MCP page choose the project and press Download workspace, or run npx searvia login once and then npx searvia workspace --project ID in the folder you work in.
- 2
Fill in your files
client.md (what you sell, to whom, what makes you different), conversions.md (the results that count), methods.md and workflow.md (how you work). Searvia writes them once with defaults and never overwrites them.
- 3
Open the folder in Claude Code
Claude reads CLAUDE.md first and follows it to the other files. .mcp.json connects it to Searvia for fresh rankings, AI answers, audits and approved fixes; the first call asks you to sign in.
- 4
Refresh the data
Run npx searvia workspace again (or download again) to rewrite the files Searvia owns: CLAUDE.md, AGENTS.md, log.md and data/ (tracked keywords, Search Console queries and pages, the latest site audit).
- 5
Add the skills
npx skills add searvia/searvia-cli installs Searvia workflows as Claude Code skills, such as keyword gaps, metadata rewrites and rank drops. The terminal command adds them to .claude/skills for you.
What you get
Claude works from your methods and current data, asks before any change, and every Searvia change and its measured result shows up in log.md.
- AGENTS.md tells the agent to cite the source and date of every number, to treat missing values as unknown, and to change nothing without your approval.
- The files are in English, the language agents work best in; deliverables are written in the language of the project.
Troubleshooting and questions
- Will a refresh overwrite my notes?
- No. Only CLAUDE.md, AGENTS.md, log.md and data/ are rewritten. Keep your own notes in wiki.md.
- Does it use credits?
- No. The workspace is built from data Searvia already has. Tools Claude calls later through MCP use credits as usual and say so first.
Also via MCP:manage_projects action=workspace