seo_geo 0.1.0

data/llms.txt

@@ -0,0 +1,27 @@
+# seo_geo (Ruby / Rails)
+
+> Rails engine for SEO and GEO (Generative Engine Optimization: visibility in AI search and assistants), not a geolocation gem. One initializer and one layout line give meta tags with canonical folding, JSON-LD from one page-copy source, crawler fallback bodies for Inertia/SPA pages, purpose-based AI crawler policy (training / search / user), per-host robots.txt, sitemap.xml, llms.txt, Markdown negotiation, IndexNow, OG images and an audit task.
+
+- Install: `gem "seo_geo"` in the Gemfile, then `bin/rails g seo_geo:install https://www.example.com`. Version 0.1.0 is not yet on RubyGems; until it is, use `gem "seo_geo", github: "seunghan91/seo_geo"`.
+- Requirements: Ruby >= 3.2, Rails 7.2 / 8.0 / 8.1 (CI covers every cell). Runtime dependencies: railties, actionpack, meta-tags ~> 2.24, reverse_markdown ~> 3.0. Optional: ferrum (OG cards), ActiveJob (IndexNow job).
+- Public API: `SeoGeo.configure`, `SeoGeo.config`, `SeoGeo.sitemap.draw { add ... }`, `SeoGeo.page(:key)`, `SeoGeo.pages.register`; view helpers `seo_geo_head`, `seo_geo_html_lang`, `seo_geo_fallback_body(:key)`, `seo_geo_faq(:key)`; controller `seo(title:, description:, image:, noindex:, index:, canonical:, type:, json_ld:)`, `seo_geo_page(:key)`; `include SeoGeo::Markdownable` + `seo_geo_markdown only:, page:`; `SeoGeo::JsonLd`; `SeoGeo::IndexNow.submit(urls)`, model macro `seo_geo_indexnow on: :publish, url:`; `rake seo_geo:audit`; `rails g seo_geo:install`; `require "seo_geo/testing"` (Minitest) and `require "seo_geo/rspec"`; `SeoGeo::BotVerifier::Middleware`; JS `window.SeoGeo.mounted()`.
+- Routes served when mounted at "/": `GET /robots.txt`, `/sitemap.xml`, `/llms.txt`, `/llms-full.txt`, `/<indexnow-key>.txt`, `/og/:key.png`, and `.md` for every Markdownable action.
+- Invariants: undeclared hosts fail closed; one copy source per page; the User-Agent is never used for access decisions; no invented lastmod.
+- License: MIT.
+
+## Docs
+
+- [README](https://github.com/seunghan91/seo_geo/blob/main/README.md): what it does, install, quick start, Inertia, configuration, limits
+- [AGENTS.md](https://github.com/seunghan91/seo_geo/blob/main/AGENTS.md): when to use it, integration recipe, invariants and check commands for coding agents
+- [Troubleshooting](https://github.com/seunghan91/seo_geo/blob/main/README.md#troubleshooting): exact error and audit messages, causes and fixes
+- [Design and configuration contract](https://github.com/seunghan91/seo_geo/blob/main/docs/DESIGN.md): every configuration key, default and public API
+- [Runnable examples](https://github.com/seunghan91/seo_geo/tree/main/docs/examples): the README and AGENTS code as app files, executed by the test suite
+- [CHANGELOG](https://github.com/seunghan91/seo_geo/blob/main/CHANGELOG.md)
+
+## Optional
+
+- [llms.txt specification](https://llmstxt.org/): the format this gem generates
+- [Which AI actually reads your site (Evil Martians, 2026)](https://evilmartians.com/chronicles/which-ai-actually-reads-your-site-two-months-of-llm-traffic-measured): agent traffic measurements behind the "HTML first, Markdown second, llms.txt cheap" design
+- [RFC 9309](https://www.rfc-editor.org/rfc/rfc9309): Robots Exclusion Protocol, which the robots.txt output follows
+- [IndexNow](https://www.indexnow.org/documentation): the protocol behind `SeoGeo::IndexNow`
+- [webmcp](https://github.com/seunghan91/webmcp): related gem that lets in-browser agents call your app's endpoints as tools

metadata

@@ -0,0 +1,224 @@
+--- !ruby/object:Gem::Specification
+name: seo_geo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- seunghan Kim
+bindir: bin
+cert_chain: []
+date: 2026-10-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: meta-tags
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.24'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.24'
+- !ruby/object:Gem::Dependency
+  name: reverse_markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: 'A Rails engine that replaces per-app SEO/GEO code with one configuration
+  file and one layout line: meta tags, canonical folding, JSON-LD, crawler fallback
+  bodies, purpose-based AI crawler policy, robots.txt, sitemap.xml, llms.txt, Markdown
+  negotiation, IndexNow and OG images. GEO means Generative Engine Optimization, not
+  geolocation.'
+email:
+- theqwe2000@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- AGENTS.md
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- app/controllers/seo_geo/index_now_controller.rb
+- app/controllers/seo_geo/llms_controller.rb
+- app/controllers/seo_geo/og_images_controller.rb
+- app/controllers/seo_geo/robots_controller.rb
+- app/controllers/seo_geo/sitemaps_controller.rb
+- app/jobs/seo_geo/index_now_job.rb
+- app/views/seo_geo/fallback/_body.html.erb
+- app/views/seo_geo/fallback/_faq.html.erb
+- config/routes.rb
+- lib/generators/seo_geo/install/install_generator.rb
+- lib/generators/seo_geo/install/templates/home.yml.tt
+- lib/generators/seo_geo/install/templates/initializer.rb.tt
+- lib/seo_geo.rb
+- lib/seo_geo/audit.rb
+- lib/seo_geo/audit/checks.rb
+- lib/seo_geo/audit/html_document.rb
+- lib/seo_geo/audit/report.rb
+- lib/seo_geo/audit/runner.rb
+- lib/seo_geo/audit/static_scan.rb
+- lib/seo_geo/bot_verifier.rb
+- lib/seo_geo/configuration.rb
+- lib/seo_geo/controller.rb
+- lib/seo_geo/crawler_fallback.rb
+- lib/seo_geo/crawlers.rb
+- lib/seo_geo/engine.rb
+- lib/seo_geo/index_now.rb
+- lib/seo_geo/json_ld.rb
+- lib/seo_geo/llms_txt.rb
+- lib/seo_geo/markdown/document.rb
+- lib/seo_geo/markdown/negotiation.rb
+- lib/seo_geo/markdown/path_suffix.rb
+- lib/seo_geo/markdownable.rb
+- lib/seo_geo/meta.rb
+- lib/seo_geo/model.rb
+- lib/seo_geo/og_image/card.html.erb
+- lib/seo_geo/og_image/ferrum_backend.rb
+- lib/seo_geo/og_image/renderer.rb
+- lib/seo_geo/page.rb
+- lib/seo_geo/path_match.rb
+- lib/seo_geo/publication.rb
+- lib/seo_geo/robots.rb
+- lib/seo_geo/robots/evaluator.rb
+- lib/seo_geo/robots_directives.rb
+- lib/seo_geo/robots_path.rb
+- lib/seo_geo/rspec.rb
+- lib/seo_geo/safe_regexp.rb
+- lib/seo_geo/sitemap/registry.rb
+- lib/seo_geo/sitemap/xml.rb
+- lib/seo_geo/testing.rb
+- lib/seo_geo/testing/environment.rb
+- lib/seo_geo/undeclared_host.rb
+- lib/seo_geo/version.rb
+- lib/tasks/seo_geo.rake
+- llms.txt
+homepage: https://github.com/seunghan91/seo_geo
+licenses:
+- MIT
+metadata:
+  changelog_uri: https://github.com/seunghan91/seo_geo/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/seunghan91/seo_geo/issues
+  documentation_uri: https://github.com/seunghan91/seo_geo#readme
+  source_code_uri: https://github.com/seunghan91/seo_geo
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: 'SEO and GEO (AI search visibility) for Rails: meta, JSON-LD, robots, sitemap,
+  llms.txt, Markdown'
+test_files: []