diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..7579398 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,9 @@ +cff-version: 1.2.0 +title: Astro SEO Toolkit +message: "If you use this software, please cite it as below." +authors: + - alias: RelayStack + website: "https://github.com/RelayStack/astro-seo-toolkit" +repository-code: "https://github.com/RelayStack/astro-seo-toolkit" +license: MIT +version: 0.4.0 diff --git a/README.md b/README.md index 2e0b5f0..c352340 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Zero-dependency SEO toolkit for Astro and static sites. Generate `llms.txt`, `si If this saves you an hour, leave a ⭐ — it keeps the project alive. -- [Tools](#tools) · [Quick start](#quick-start) · [AI agent skill](#use-with-your-ai-agent) · [Wiring into Astro](#wiring-into-astro) · [Locales](#locales) · [Layout](#layout) · [Contributing](#contributing) +- [Tools](#tools) · [Quick start](#quick-start) · [AI agent skill](#use-with-your-ai-agent) · [Wiring into Astro](#wiring-into-astro) · [Locales](#locales) · [Layout](#layout) · [Contributing](#contributing) · [FAQ](#faq) ## Tools @@ -104,6 +104,24 @@ package.json npx bins: astro-seo-llms, -sitemap, -robots, -indexnow Questions, ideas, bug reports: use [Discussions](../../discussions). PRs welcome — keep helpers dependency-free and tested (`npm test`). +## FAQ + +### Is this an Astro integration? + +No. It is framework-agnostic Node scripts plus Astro wiring guides and an example. Anything with a Markdown directory and a Node build step works: Astro, Eleventy, Hugo, Next.js static export. + +### Does llms.txt improve Google rankings? + +No. Google ignores `llms.txt`; it serves Claude, GPT, Perplexity and other agents. For Google, prioritize sitemap submission, real indexation, one valid JSON-LD block per page, and quotable content. + +### How is this different from astro-seo? + +`astro-seo` is a meta-tags component for your ``. This toolkit generates the files around it — `llms.txt`, `llms-full.txt`, `sitemap.xml`, `robots.txt` — plus JSON-LD builders, IndexNow submission, a dist validator, and an agent skill that wires it all up. + +### Can my AI agent install and use this? + +Yes. `npx skills add RelayStack/astro-seo-toolkit --skill astro-seo`, or copy `skills/astro-seo/` into any harness skills dir, or run everything via `npx -y github:RelayStack/astro-seo-toolkit ` with no install. + ## License MIT — see LICENSE. By RelayStack. diff --git a/package.json b/package.json index 5603adf..4783c0d 100644 --- a/package.json +++ b/package.json @@ -12,6 +12,7 @@ "astro-seo-indexnow": "./seo-toolkit/indexnow.mjs" }, "keywords": ["seo", "astro", "json-ld", "llms-txt", "indexnow", "sitemap", "geo"], + "homepage": "https://github.com/RelayStack/astro-seo-toolkit#readme", "files": ["seo-toolkit/", "skills/", "examples/", "notes/", "README.md", "LICENSE", "CHANGELOG.md"], "exports": { "./llms-txt": "./seo-toolkit/llms-txt.mjs",