{"id":13417787,"url":"https://github.com/jonasmerlin/astro-seo","last_synced_at":"2026-01-16T20:07:38.674Z","repository":{"id":40563922,"uuid":"400754661","full_name":"jonasmerlin/astro-seo","owner":"jonasmerlin","description":"Makes it easy to add information that is relevant for SEO to your Astro app.","archived":false,"fork":false,"pushed_at":"2026-01-13T15:06:18.000Z","size":3103,"stargazers_count":1242,"open_issues_count":0,"forks_count":61,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-13T15:55:45.191Z","etag":null,"topics":["astro","seo"],"latest_commit_sha":null,"homepage":"","language":"Astro","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/jonasmerlin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2021-08-28T09:35:19.000Z","updated_at":"2026-01-13T15:15:51.000Z","dependencies_parsed_at":"2024-06-18T13:43:35.862Z","dependency_job_id":"c801582c-8c5d-4769-8dbe-896640291d84","html_url":"https://github.com/jonasmerlin/astro-seo","commit_stats":{"total_commits":165,"total_committers":19,"mean_commits":8.68421052631579,"dds":0.5151515151515151,"last_synced_commit":"1aeb03b1cd3aa0de94c3a7eb1b929ffd613fa49a"},"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/jonasmerlin/astro-seo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasmerlin%2Fastro-seo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasmerlin%2Fastro-seo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasmerlin%2Fastro-seo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasmerlin%2Fastro-seo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonasmerlin","download_url":"https://codeload.github.com/jonasmerlin/astro-seo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasmerlin%2Fastro-seo/sbom","scorecard":{"id":530069,"data":{"date":"2025-08-11","repo":{"name":"github.com/jonasmerlin/astro-seo","commit":"9c75201be25d8b90a3936e7517f49e888e11662e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.9,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":3,"reason":"Found 7/22 approved changesets -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: cypress/downloads/downloads.html:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":4,"reason":"dependency not pinned by hash detected -- score normalized to 4","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/jonasmerlin/astro-seo/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/jonasmerlin/astro-seo/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/jonasmerlin/astro-seo/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/jonasmerlin/astro-seo/ci.yml/main?enable=pin","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   1 out of   1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 15 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"29 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-m85w-3h95-hcf9","Warn: Project is vulnerable to: GHSA-c4pw-33h3-35xw","Warn: Project is vulnerable to: GHSA-49w6-73cw-chjr","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-f6v4-cf5j-vf3w","Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-x7hr-w5r2-h6wg","Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-pq67-2wwv-3xjx","Warn: Project is vulnerable to: GHSA-8cj5-5rvv-wf4v","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-8jhw-289h-jh2g","Warn: Project is vulnerable to: GHSA-64vr-g452-qvp3","Warn: Project is vulnerable to: GHSA-9cwx-2883-4wfx","Warn: Project is vulnerable to: GHSA-vg6x-rcgg-rjx6","Warn: Project is vulnerable to: GHSA-x574-m823-4x7w","Warn: Project is vulnerable to: GHSA-4r4m-qw57-chr8","Warn: Project is vulnerable to: GHSA-xcj6-pq6g-qj4x","Warn: Project is vulnerable to: GHSA-356w-63v5-8wf4","Warn: Project is vulnerable to: GHSA-859w-5945-r5v3"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T05:28:50.162Z","repository_id":40563922,"created_at":"2025-08-20T05:28:50.162Z","updated_at":"2025-08-20T05:28:50.162Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["astro","seo"],"created_at":"2024-07-30T22:00:52.631Z","updated_at":"2026-01-16T20:07:38.668Z","avatar_url":"https://github.com/jonasmerlin.png","language":"Astro","funding_links":[],"categories":["What Do I Use...","Astro","Astro Packages/Libraries","Community Integrations"],"sub_categories":["If I want to add SEO?","SEO \u0026 Analytics"],"readme":"![Astro SEO Logo](https://user-images.githubusercontent.com/5182256/131216951-8f74f425-f775-463d-a11b-0e01ad9fce8d.png)\n\n# 🚀 Astro SEO\n\nThis [Astro](https://astro.build/) component makes it easy to add tags that are\nrelevant for search engine optimization (SEO) to your pages.\n\nThe ultimate goal is to make this the one-stop shop for most of your SEO needs when developing Astro sites.\n\nPull requests and/or feature requests are very welcome!\n\n## Installation\n\nTo install Astro SEO, run the following command in your terminal:\n\n```bash\nnpm install astro-seo\n```\n\nor if you use yarn:\n  \n```bash\nyarn add astro-seo\n```\n\n## How To Use\n\nIn any of your Astro pages, import Astro SEO and then use the component inside\nthe `\u003chead\u003e` section of your HTML:\n\n```astro\n---\nimport { SEO } from \"astro-seo\";\n---\n\n\u003chtml lang=\"en\"\u003e\n  \u003chead\u003e\n    \u003cSEO\n      title=\"A Very Descriptive Title\"\n      description=\"A heavily optimized description full of well-researched keywords.\"\n      openGraph={{\n        basic: {\n          title: \"A Very Descriptive Title\",\n          type: \"A type.\",\n          image: \"https://user-images.githubusercontent.com/5182256/131216951-8f74f425-f775-463d-a11b-0e01ad9fce8d.png\",\n        }\n      }}\n      twitter={{\n        creator: \"@jonasmerlins1\"\n      }}\n      extend={{\n        // extending the default link tags\n        link: [{ rel: \"icon\", href: \"/favicon.ico\" }],\n        // extending the default meta tags\n        meta: [\n          {\n            name: \"twitter:image\",\n            content: \"https://user-images.githubusercontent.com/5182256/131216951-8f74f425-f775-463d-a11b-0e01ad9fce8d.png\",\n          },\n          { name: \"twitter:title\", content: \"Tinker Tailor Soldier Spy\" },\n          { name: \"twitter:description\", content: \"Agent\" },\n        ],\n      }}\n    /\u003e\n    // ... rest of \u003chead\u003e\n  \u003c/head\u003e\n    \u003cbody\u003e // ... body \u003c/body\u003e\n\u003c/html\u003e\n```\n\n## Using with Layouts\n\nA common Astro pattern is to have a Layout component that wraps your pages and contains the `\u003chead\u003e` element. To pass SEO properties from your pages to the layout, use Astro's standard props pattern:\n\n**Layout.astro:**\n```astro\n---\nimport { SEO } from \"astro-seo\";\n\ninterface Props {\n  title: string;\n  description?: string;\n}\n\nconst { title, description } = Astro.props;\n---\n\n\u003chtml lang=\"en\"\u003e\n  \u003chead\u003e\n    \u003cSEO\n      title={title}\n      description={description}\n    /\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003cslot /\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n**index.astro (your page):**\n```astro\n---\nimport Layout from \"../layouts/Layout.astro\";\n---\n\n\u003cLayout title=\"Homepage\" description=\"Welcome to my site\"\u003e\n  \u003ch1\u003eHello!\u003c/h1\u003e\n\u003c/Layout\u003e\n```\n\nThis pattern allows each page to define its own SEO values while keeping the `\u003cSEO\u003e` component in a single, reusable layout. For more information on layouts and passing props between components, see the [Astro Layouts documentation](https://docs.astro.build/en/basics/layouts/).\n\n## Supported Props\n\nPropname | Type | Description\n------------ | ------------- | -------------\ntitle | string | The title of the page.\ntitleTemplate | string | Provide a title template to keep a consistent title style. `%s — Astro SEO`, `%s` will be replaced with your title, e.g. `Homepage — Astro SEO`\ntitleDefault | string | Fallback title that is used if no title is provided.\ndescription | string | Text that gives a concise description of what your page is about.\ncanonical | string | Prevent duplicate content issues by specifying the \"canonical\" or \"preferred\" url of a web page. If you don't define this, `Astro.url.href` will be used as the default value.\nnoindex | boolean | Set this to true if you don't want search engines to index your page. Since this is an SEO component, this gets set to `false` by default. This way, indexing is strictly opt-out.\nnofollow | boolean | Set this to true if you don't want search engines to follow links on your page. Since this is an SEO component, this gets set to `false` by default. This way, following links is strictly opt-out.\nnoarchive | boolean | Set this to true if you don't want search engines to show a cached link for your page.\nnocache | boolean | Set this to true if you don't want search engines to cache your page content.\nrobotsExtras | string | Additional robots directives not covered by the boolean options above. Useful for directives like `max-snippet:-1`, `max-image-preview:large`, `max-video-preview:-1`. Pass as a comma-separated string, e.g. `\"max-snippet:-1, max-image-preview:large\"`.\ncharset | string | Set the charset of the document. In almost all cases this should be UTF-8.\nlanguageAlternates | Array\u003c{ href: string; hrefLang: string }\u003e | List of language alternates for the page.\nopenGraph.basic.title | string | Set the title Open Graph should use. __In most situations, this should be _different_ from the value of the `title` prop.__ See [this tweet](https://twitter.com/jon_neal/status/1428721238071988237) to gain an understanding of the difference between the two. If you define this, you must define two other OG basic properties as well: `type` and `image`. ([Learn more.](https://ogp.me/#metadata))\nopenGraph.basic.type | string | Set the [type](https://ogp.me/#types) Open Graph should use. If you define this, you must define two other OG basic properties as well: `title` and `image`. ([Learn more.](https://ogp.me/#metadata))\nopenGraph.basic.image | string | URL of the image that should be used in social media previews. If you define this, you must define two other OG basic properties as well: `title` and `type`. ([Learn more.](https://ogp.me/#metadata))\nopenGraph.basic.url | string | The canonical URL of your object that will be used as its permanent ID in the graph. Most likely either the url of the page or its canonical url (see above). If you define this, you must define the other 3 OG basic properties as well: `title`, `type` and `image`. ([Learn more.](https://ogp.me/#metadata)). If you define the other 3 OG basic properties but don't define this, `Astro.request.url.href` will be used as the default value.\nopenGraph.optional.audio | string | A URL to an audio file to accompany this object.\nopenGraph.optional.description | string | A one to two sentence description of your object.\nopenGraph.optional.determiner | string | The word that appears before this object's title in a sentence. An enum of (a, an, the, \"\", auto). If auto is chosen, the consumer of your data should chose between \"a\" or \"an\". Default is \"\" (blank).\nopenGraph.optional.locale | string | The locale these tags are marked up in. Of the format language_TERRITORY. Default is en_US.\nopenGraph.optional.localeAlternate | Array\u003cstring\u003e | An array of other locales this page is available in.\nopenGraph.optional.siteName | string | If your object is part of a larger web site, the name which should be displayed for the overall site. e.g., \"IMDb\".\nopenGraph.optional.video | string | A URL to a video file that complements this object.\nopenGraph.image.url | string | For now, setting this is ignored. This is done because `og:image:url` is supposed to be identical to `og:image`. If you have a use case where it makes sense for these to be different, please feel free to contact me, and tell me about it and I will consider adding it. Until then, in the interest of enforcing best practices, the value of this property will be ignored and `og:image:url` set to the value of `openGraph.basic.image`.\nopenGraph.image.secureUrl | string | Sets `og:image:secure_url`: An alternate url to use if the webpage requires HTTPS.\nopenGraph.image.type | string | Sets `og:image:type`. A MIME type for the image. e.g. \"image/jpeg\"\nopenGraph.image.width | number | Sets `og:image:width`. The number of pixels wide.\nopenGraph.image.height | number | Sets `og:image:height`. The number of pixels high.\nopenGraph.image.alt | string | Sets `og:image:alt`. A description of what is in the image (not a caption). __If the page specifies `openGraph.basic.image` it should specify `openGraph.image.alt`__.\nopenGraph.article.publishedTime | string | Sets `article:published_time`. The date the article was published. Must be a ISO 8601 DateTime string.\nopenGraph.article.modifiedTime | string | Sets `article:modified_time`. The date the article was last modified. Must be a ISO 8601 DateTime string.\nopenGraph.article.expirationTime | string | Sets `article:expiration_time`. The date the article will no longer be relevant. Must be a ISO 8601 DateTime string.\nopenGraph.article.authors | string[] | Sets `article:author`. The author(s) of the article, if it's only one, pass an array with one entry. If there are multiple, multiple tags with descending relevance will be created.\nopenGraph.article.section | string | Sets `article:section`. A high-level section name. E.g. Technology\nopenGraph.article.tags | string[] | Sets `article:tag`. Tag words associated with this article. If it's only one, pass an array with one entry. If there are multiple, multiple tags with descending relevance will be created.\ntwitter.card | TwitterCardType (string) | Sets `twitter:card`. The card type. Must be one of “summary”, “summary_large_image”, “app”, or “player”.\ntwitter.site | string | Sets `twitter:site`. (Twitter) @username for the website used in the card footer.\ntwitter.creator | string | Sets `twitter:creator`. (Twitter) @username for the content creator / author.\ntwitter.title | string | Sets `twitter:title`. Title of the page or article (equivalent to Open Graph's og:title).\ntwitter.image | string | Sets `twitter:image`. Full link to the image you want to use for the page (equivalent to Open Graph's og:image).\ntwitter.imageAlt | string | Sets `twitter:image:alt`. A description of what is in the image (not a caption). __If the page specifies `twitter.image` it should specify `twitter.imageAlt`__.\ntwitter.description | string | Sets `twitter:description`. A one to two sentence description of your object.\nextend.link | Array\u003cLink extends HTMLLinkElement { prefetch: boolean; }\u003e | An array of free-form `\u003clink\u003e` you'd like to define.\nextend.meta | Array\u003cMeta extends HTMLMetaElement { property: string; }\u003e | An array of free-form `\u003cmeta\u003e` tags you'd like to define.\nremoveTrailingSlashForRoot | boolean | Removes the trailing slash when only the root path is displayed (e.g. `https://example.com/` becomes `https://example.com`). For SEO purposes these are equivalent (search engines treat them the same), but this option helps match the expectation for users with Astro's trailingSlash: 'never'. This option gets set to `false` by default.\n\n## Extending Astro SEO\n\nWith the `v0.3.14` release, you can now define any `\u003cmeta\u003e` and `\u003clink\u003e` tag you want using the `extend` prop. For example :\n\n```js\n\u003cSEO\n  extend={{\n    // extending the default link tags\n    link: [{ rel: \"icon\", href: \"/favicon.ico\" }],\n    // extending the default meta tags\n    meta: [\n      {\n        name: \"twitter:image\",\n        content:\n          \"https://user-images.githubusercontent.com/5182256/131216951-8f74f425-f775-463d-a11b-0e01ad9fce8d.png\",\n      },\n      { name: \"twitter:title\", content: \"Tinker Tailor Soldier Spy\" },\n      { name: \"twitter:description\", content: \"Agent\" },\n    ],\n  }}\n/\u003e\n```\n\n## Open Graph\n\nOpen Graph properties are passed as one object to the prop `openGraph`. The structure of this object is modeled after the [Open Graph documentation](https://ogp.me/) itself. That means it uses nested objects to differentiate between basic and optional properties, as well as object specific ones. __If you pass an openGraph config, you _must_ define all 4 of the basic properties (`title`, `type`, `image` and `url`).__ The optional properties are all ... well, optional.\n\n```typescript\n// TypeScript interface of openGraph prop\nopenGraph?: {\n  basic: {\n    title: string;\n    type: string;\n    image: string;\n    url: string;\n  },\n  optional?: {\n    audio?: string;\n    description?: string;\n    determiner?: string;\n    locale?: string;\n    localeAlternate?: Array\u003cstring\u003e;\n    siteName?: string;\n    video?: string;\n  }\n}\n```\n\n## Goals\n\nOur first goal for this project is to support the most-used tags that are\nrelevant for SEO. That includes the most-used open graph tags.\n\nAfter that comes feature-parity with Next SEO. After _that_ ... we'll see.\n\n## What does this component do, exactly?\n\nThere's certainly no magic to what Astro SEO does. Basically, it bundles the\ncreation of regular SEO-relevant HTML tags inside one component that you can\nthen use inside your page's `\u003chead\u003e` tag.\n\nThe translation between props and tags is pretty direct and almost 1:1. After\nbuilding, there probably won't be anything you wouldn't have written yourself.\nThe idea is to surface the options that exist in a central place and adhere to\nbest practices where it's theoretically possible not to. __If you want to see\nhow the sausage gets made, there's only one place you will have to check__:\n`/src/SEO.astro`\n\nIf you want, you can view Astro SEO as a checklist, so you don't forget a tag.\nOr maybe also as an educational tool, to see which options exist in the first\nplace.\n\n## Acknowledgements\n\nAstro SEO is _heavily_ inspired by [Next SEO](https://github.com/garmeeh/next-seo)\nand all the amazing work Gary is doing developing it. Thanks Gary! ❤️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasmerlin%2Fastro-seo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonasmerlin%2Fastro-seo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasmerlin%2Fastro-seo/lists"}