{"id":49147462,"url":"https://github.com/jdevalk/seo-graph","last_synced_at":"2026-04-22T04:37:53.381Z","repository":{"id":350186332,"uuid":"1205693453","full_name":"jdevalk/seo-graph","owner":"jdevalk","description":"Agent-ready SEO for JavaScript — schema.org JSON-LD graph builder with an Astro integration.","archived":false,"fork":false,"pushed_at":"2026-04-09T08:04:33.000Z","size":81,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T09:29:22.085Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://joost.blog","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jdevalk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-09T07:41:04.000Z","updated_at":"2026-04-09T08:04:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jdevalk/seo-graph","commit_stats":null,"previous_names":["jdevalk/seo-graph"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jdevalk/seo-graph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdevalk%2Fseo-graph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdevalk%2Fseo-graph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdevalk%2Fseo-graph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdevalk%2Fseo-graph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jdevalk","download_url":"https://codeload.github.com/jdevalk/seo-graph/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jdevalk%2Fseo-graph/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32121437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-22T04:37:51.228Z","updated_at":"2026-04-22T04:37:53.365Z","avatar_url":"https://github.com/jdevalk.png","language":"TypeScript","funding_links":[],"categories":["Open-Source Repos \u0026 Tools"],"sub_categories":["Structured Data \u0026 Schema"],"readme":"# seo-graph\n\n[![CI](https://github.com/jdevalk/seo-graph/actions/workflows/ci.yml/badge.svg)](https://github.com/jdevalk/seo-graph/actions/workflows/ci.yml)\n[![seo-graph-core npm](https://img.shields.io/npm/v/%40jdevalk%2Fseo-graph-core?label=%40jdevalk%2Fseo-graph-core)](https://www.npmjs.com/package/@jdevalk/seo-graph-core)\n[![astro-seo-graph npm](https://img.shields.io/npm/v/%40jdevalk%2Fastro-seo-graph?label=%40jdevalk%2Fastro-seo-graph)](https://www.npmjs.com/package/@jdevalk/astro-seo-graph)\n[![license](https://img.shields.io/github/license/jdevalk/seo-graph)](./LICENSE)\n\n\u003e Agent-ready SEO for JavaScript. A pure schema.org JSON-LD graph builder plus\n\u003e an Astro integration, designed to be shared across frameworks and CMSes.\n\nThis monorepo ships two packages (plus a third consumer living elsewhere):\n\n| Package                                                                      | Purpose                                                                                                                                     |\n| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |\n| [`@jdevalk/seo-graph-core`](./packages/seo-graph-core)                       | Pure, runtime-agnostic schema.org piece builders and graph assembler. Depends only on [`schema-dts`](https://github.com/google/schema-dts). |\n| [`@jdevalk/astro-seo-graph`](./packages/astro-seo-graph)                     | Astro integration: `\u003cSeo\u003e` component, route factories for agent-ready endpoints, breadcrumb helper, Zod content helpers.                    |\n| [`@jdevalk/emdash-plugin-seo`](https://github.com/jdevalk/emdash-plugin-seo) | EmDash CMS plugin. Lives in its own repo, depends on `seo-graph-core`.                                                                      |\n\n## Documentation\n\nSee [AGENTS.md](./AGENTS.md) for the full reference: all builder signatures,\nsite-type recipes (blog, e-commerce, local business, docs, podcast, etc.),\nand schema.org best practices. It's written for both humans and AI coding\nagents.\n\n## Why\n\nRead more about [why this project exists](https://joost.blog/seo-graph/).\n\n## Develop\n\n```sh\npnpm install\npnpm typecheck\npnpm build\npnpm test\n```\n\n## Architecture notes\n\n- **No page-type enum in core.** Core exposes piece builders; dispatch lives in\n  the caller. This keeps the core's API surface small and avoids baking a\n  specific content model into a shared lib.\n- **[`schema-dts`](https://github.com/google/schema-dts) is the type substrate.**\n  All builders accept schema.org properties at the top level with full\n  autocomplete from `schema-dts`. `buildPiece\u003cProduct\u003e` gives you every\n  Product property typed; the `@type` value narrows union types to the\n  matching leaf automatically.\n- **Dedicated builders for non-trivial work.** Seven builders handle ID\n  generation, date conversion, and transforms (`buildWebSite`, `buildWebPage`,\n  `buildArticle`, `buildBreadcrumbList`, `buildImageObject`, `buildVideoObject`,\n  `buildSiteNavigationElement`). Everything else — Person, Organization, Blog,\n  Product, Recipe, Event, etc. — uses `buildPiece\u003cType\u003e`.\n- **Breadcrumbs are an input, not a derivation.** Callers pre-compute the\n  breadcrumb list. The Astro integration ships `breadcrumbsFromUrl` to\n  derive crumbs from an `Astro.url`, but the core itself has no\n  URL-parsing logic.\n\n## License\n\nMIT © Joost de Valk\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdevalk%2Fseo-graph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjdevalk%2Fseo-graph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjdevalk%2Fseo-graph/lists"}