seo/seo library
Camada de otimização automática do Flenx: SEO + GEO + AEO + LLMs.
Fonte única (RouteRegistry) → meta tags, JSON-LD, sitemap, robots, llms.txt.
Classes
- Breadcrumb
-
Item de trilha de navegação, usado para gerar JSON-LD
BreadcrumbList(rich result de breadcrumb no SERP). O último item costuma vir sempath. - CrawlerRule
-
Regra de um grupo
User-agentno robots.txt. -
DynamicRouteSource<
T> -
Esquema GENÉRICO para rotas dinâmicas (ex.:
/blog/:slug,/produtos/:id) gerarem sitemap/llms automaticamente. - FaqItem
-
Par pergunta/resposta usado para gerar JSON-LD
FAQPage(forte em AEO/GEO: motores de resposta extraem perguntas estruturadas diretamente). - IRouteSource
- Contrato de uma fonte de rotas. Cada fonte sabe produzir a lista de RouteMeta que representa — estáticas ou expandidas de dados dinâmicos.
- JsonLdGenerator
- Constrói os objetos schema.org (JSON-LD) de uma página: Organization e WebSite (site-wide) + o tipo da página (Article/FAQPage/...) + BreadcrumbList.
- LlmsFullGenerator
-
Gera o
/llms-full.txt: todo o conteúdo do site concatenado em Markdown, para ingestão completa por LLMs/agentes. - LlmsTxtGenerator
-
Gera o
/llms.txtno formato llmstxt.org: H1 com o nome, blockquote de resumo e seções H2 com listas de links curados- [título](url): resumo. - MetaTagsBuilder
-
Constrói os componentes do
<head>para uma rota: meta description, robots, canonical, Open Graph, Twitter Cards, theme-color, hreflang e os blocos JSON-LD. O<title>é tratado peloDocument(title:). - RobotsTxtGenerator
-
Gera o
robots.txta partir das regras por crawler do SeoConfig, referenciando o sitemap. Inclui buscadores tradicionais e crawlers de IA. - RouteMeta
- Metadados de UMA rota — a fonte única de verdade. A partir dela o framework deriva automaticamente: meta tags, Open Graph/Twitter, JSON-LD, entrada no sitemap, item do llms.txt e conteúdo do llms-full.txt.
- RouteRegistry
-
Agrega múltiplas IRouteSource (estáticas + dinâmicas) e resolve todas as
rotas do site num único conjunto deduplicado por
path. - SeoAddress
- Endereço físico para schema.org LocalBusiness (PostalAddress + GeoCoordinates).
- SeoConfig
- Configuração global de SEO/GEO/AEO do site. Fonte única para baseUrl, identidade da organização e política de crawlers.
- SeoEndpoints
-
Monta os endpoints de otimização servidos automaticamente pelo servidor:
/robots.txt,/sitemap.xml,/llms.txte/llms-full.txt. - SeoService
-
Um serviço oferecido pela empresa — vira schema.org
Serviceno JSON-LD. Ajuda GEO/AEO: motores de IA citam serviços específicos ("quem faz X em SP?"). - SitemapIndexGenerator
-
Gera um
<sitemapindex>apontando para múltiplos sitemaps — usado quando o site excede 50.000 URLs (ou 50MB) por arquivo. - SitemapXmlGenerator
-
Gera um
sitemap.xml(urlset) válido conforme sitemaps.org 0.9, incluindolastmod,changefreq,prioritye alternâncias hreflang quando houver. - StaticRouteSource
- Fonte de rotas estáticas — páginas fixas conhecidas em tempo de build (home, sobre, contato, etc.). Equivale às páginas do file-based routing.
Enums
- ChangeFreq
- Frequência de mudança de uma URL no sitemap (spec sitemaps.org 0.9).
- PageKind
-
Tipo semântico de uma página. Mapeia para
og:type(Open Graph) e para o@typedo schema.org (JSON-LD), permitindo gerar dados estruturados certos.