Discover and normalize entities for programmatic SEO from a seed keyword or CSV file. Writes normalized entities to data/entities.json. Use when the user wants to find, import, or expand a list of SEO targets.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Turn a seed keyword or CSV file into normalized entities ready for page generation.
Invoke the sophon skill first. It contains the entity model, adapter map, operating rules, and the Context Gathering Protocol.
Follow the protocol before doing any work:
## Sophon Project Context section..sophon.md in the project root.sophon teach now — do NOT skip this step.| Flag | Description |
|---|---|
--seed <keyword> | Expand a niche into entity candidates |
--csv <path> | Import entities from a CSV file |
--pattern <template> | Custom expansion pattern (repeatable) |
--discover-output <path> | Override default data/entities.json output |
When both --seed and --csv are provided, CSV is used and seed input is ignored.
# From seed keyword
npx @sophonn/sophon discover --seed "best payroll software"
# Custom expansion patterns (prefer repeated --pattern over a single --patterns flag)
npx @sophonn/sophon discover \
--seed "best payroll software" \
--pattern "{seed} alternatives" \
--pattern "{seed} pricing" \
--pattern "best {seed}"
# From CSV
npx @sophonn/sophon discover --csv ./input/entities.csv
Discovery writes to data/entities.json by default (or --discover-output when provided).
Key guarantees:
metadata.attributes so downstream generation can use them.technical step.import { discover } from "@sophonn/sophon";
const result = await discover({ seed: "best payroll software" });
// result.entities: Entity[]
Verify the output at data/entities.json, then run the generate skill to scaffold framework pages.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Enrich discovered entities with AI-generated content using Claude via the Anthropic SDK. Outputs structured JSON per entity for downstream use in page templates. Requires ANTHROPIC_API_KEY (or use --dry-run to preview prompts).
The English summary is being prepared. Showing the original description.
Generate one static framework page per entity using the appropriate Sophon adapter. Supports Next.js, Astro, Nuxt, SvelteKit, and Remix. Use when the user wants to scaffold programmatic SEO pages.
The English summary is being prepared. Showing the original description.
Pull real performance data from Google Search Console, analyze weak-performing pages, and generate actionable optimization recommendations. Optionally applies safe auto-fixes to Sophon-generated content.
The English summary is being prepared. Showing the original description.
Execute the full Sophon pipeline: discover → generate → technical → enrich. Use when the user wants to run all steps in one command or build a complete pSEO surface from scratch.
The English summary is being prepared. Showing the original description.
Master context for Sophon — an agentic programmatic SEO toolkit. Teaches the framework, entity model, adapter system, and operating rules. Invoke this skill before using discover, generate, technical, enrich, optimize, or run so you have the full context. Call with 'teach' to run the onboarding interview and create .sophon.md.
The English summary is being prepared. Showing the original description.
Generate technical SEO assets: sitemap.xml (with sitemap index for large sites), robots.txt, per-entity schema markup (BreadcrumbList, AggregateRating), configurable internal link graph, and hreflang scaffold. Use when the user wants to add or update sitemap, robots, structured data, internal linking, or multilingual hreflang tags.
The English summary is being prepared. Showing the original description.