Discourse Rich JSON-LD Microdata
 |
Resumo | Amplia as meta tags padrão do Discourse com um conjunto abrangente e coordenado de marcação Open Graph, Twitter Cards e Schema.org JSON-LD, resultando em desempenho superior de SEO, experiências de compartilhamento em redes sociais mais ricas e melhor descoberta por IA/LLM |
 |
Link do Repositório | GitHub - kaktaknet/discourse-rich-json-ld-microdata: 🏆 Discourse Rich JSON-LD Microdata Plugin. Comprehensive, coordinated Open Graph and Schema.org JSON-LD microdata for 200% SEO and LLM coverage · GitHub |
 |
Guia de Instalação | Como instalar plugins no Discourse |
O Que Você Ganha
Transforme a forma como seu fórum aparece nos resultados de pesquisa, redes sociais e assistentes inteligentes. Este plugin gera dados estruturados de nível profissional que o Google, Yandex, plataformas sociais e Grandes Modelos de Linguagem (LLMs) compreendem perfeitamente.
Para documentação detalhada, veja README.md
Para detalhes técnicos e desenvolvimento, veja CONTRIBUTING.md
Para exemplos de uso e solução de problemas, veja USAGE.md
Exemplos de Resultados de Pesquisa Ricos
Antes: Trecho de texto simples no Google
Depois: Trecho rico com classificações, contagem de respostas, autor e data de publicação
Antes: Pré-visualização de link genérica em redes sociais
Depois: Cartão chamativo com imagem, descrição e marca
Saiba mais sobre Resultados Ricos do Google Search Central
Principais Recursos
1. Cobertura Completa do Schema.org
- Esquema QAPage para tópicos com hierarquia completa de Perguntas e Respostas
- Suporte a classificações de respostas e status de resolvido
- CollectionPage para categorias com subcategorias
- ProfilePage para perfis de usuário com indicadores de especialização
- BreadcrumbList para caminhos de navegação
- Esquema global WebSite com ação de pesquisa
2. Tags de Redes Sociais Coordenadas
- Open Graph (Facebook, LinkedIn, Discord)
- Twitter Cards (summary_large_image)
- Tudo gerado a partir de única fonte da verdade — sem conflitos
- Limpeza automática das tags padrão do Discourse
3. Otimizado para IA e LLM
- Relações completas de entidades usando referências
@iddo Schema.org - Compreensão total do contexto (tópicos → categorias → respostas → comentários)
- Metadados de especialização do autor
- ChatGPT, Claude e outros assistentes de IA recebem contexto perfeito
4. Internacionalização Completa 
- Traduções em 100% inglês e russo incluídas
- Detecção automática de idioma (usuário → site → navegador → fallback)
- Todas as descrições do Schema.org localizadas
- Fácil adicionar mais idiomas
5. Desempenho Inteligente
- Cache Redis com TTL de 1 hora (configurável)
- Invalidação automática do cache em alterações de conteúdo
- < 5ms para páginas em cache
- ~50ms para geração nova
6. Zero Manutenção
- Injeção automática para visualizações de navegador e rastreador
- Funciona para tópicos, categorias e perfis de usuário
- Tratamento de erros elegante — nunca quebra seu site
- Logs abrangentes para depuração
Benefícios para Seu Fórum
Melhores Classificações de Pesquisa
- Trechos ricos no Google aumentam as taxas de cliques em 30-50%
- Painéis do Knowledge Graph para usuários especialistas
- Destaque nas seções “Pessoas também perguntam”
- Breadcrumbs nos resultados de pesquisa melhoram a navegação
Compartilhamento Profissional em Redes Sociais
- Cartões chamativos ao compartilhar no Facebook, Twitter, LinkedIn
- Marca adequada com logotipos e descrições
- Aumento no engajamento e taxas de cliques
- Funciona em mais de 40 plataformas sociais
Pronto para Assistente de IA
- Seu conteúdo aparece com precisão nas respostas do ChatGPT e Claude
- Atribuição correta com links de volta ao seu fórum
- Contexto completo previne alucinações da IA
- Futuro-proof para Otimização de Motores Generativos (GEO)
Público Internacional
- Detecção automática de idioma
- Descrições localizadas para maior relevância
- Codificação de URL lida com caracteres cirílicos e especiais
- Fácil expansão para mais idiomas
Instalação
Passo 1: Instalar
Siga Install plugins on a self-hosted site usando o link do repositório acima
Passo 2: Habilitar no Admin
Navegue até Admin → Configurações → Plugins → Rich Microdata
Defina rich_microdata_enabled como true (habilitado por padrão)
Passo 3: Configurar (Opcional)
Todas as configurações funcionam bem fora da caixa, mas você pode personalizar:
- Duração do cache (padrão: 1 hora)
- Máximo de respostas a incluir (padrão: 10)
- @handle do Twitter para seu site
- URL padrão da imagem Open Graph
- Habilitar/desabilitar esquemas específicos
Passo 4: Verificar
Teste sua marcação:
Configuração
| Configuração | Padrão | Descrição |
|---|---|---|
rich_microdata_enabled |
true |
Interruptor mestre do plugin |
rich_microdata_cache_ttl |
3600 |
Duração do cache em segundos |
rich_microdata_max_answers |
10 |
Máximo de respostas no esquema QAPage |
rich_microdata_include_user_stats |
true |
Incluir estatísticas do usuário |
rich_microdata_enable_breadcrumbs |
true |
Adicionar esquema BreadcrumbList |
rich_microdata_enable_website_schema |
true |
Incluir esquema WebSite |
rich_microdata_twitter_site |
"" |
Seu @username do Twitter |
rich_microdata_og_image_default |
"" |
URL de imagem OG de fallback |
rich_microdata_debug_mode |
false |
Habilitar log de depuração |
Detalhes Técnicos
Arquitetura:
- Padrão de três camadas: DataExtractor → Builders → Coordinator
- Única fonte da verdade previne conflitos de dados
- Renderização separada para tags
<head>e conteúdo<body> - Funciona com layouts
application.html.erbecrawler.html.erb
Conformidade com Padrões:
- Especificação Schema.org JSON-LD
- Protocolo Open Graph
- Marcações Twitter Cards
- RFC 3986 (codificação de URL para caracteres internacionais)
Segurança:
- Verificações de permissão do Guardian
- Conteúdo privado automaticamente excluído
- Filtragem de segurança no nível SQL
- Fallbacks seguros para dados ausentes
Compatibilidade:
- Discourse 2.7.0+
- Ruby 2.7+
- Testado no Discourse 3.6.0.beta3
Exemplos do Mundo Real
Marcação de Página de Tópico:
{
"@context": "https://schema.org",
"@type": "QAPage",
"name": "Como otimizar consultas de banco de dados?",
"mainEntity": {
"@type": "Question",
"name": "Como otimizar consultas de banco de dados?",
"text": "Estou tendo consultas lentas...",
"answerCount": 5,
"upvoteCount": 12,
"acceptedAnswer": {
"@type": "Answer",
"text": "Você deve adicionar índices em...",
"upvoteCount": 8,
"author": {
"@type": "Person",
"name": "João Silva",
"url": "https://forum.exemplo.com/u/joao"
}
}
}
}
Marcação de Página de Categoria:
{
"@context": "https://schema.org",
"@type": "CollectionPage",
"name": "Otimização de Banco de Dados",
"description": "Dicas e truques para consultas mais rápidas",
"numberOfItems": 245,
"hasPart": [...]
}
Veja USAGE.md para exemplos completos.
Casos de Uso
Fóruns Técnicos:
Desenvolvedores encontram suas soluções através dos trechos em destaque do Google e assistentes de codificação de IA, com o contexto de código preservado adequadamente.
Comunidades de Suporte:
Mecanismos de pesquisa exibem suas respostas com classificações e status de resolvido, direcionando tráfego qualificado para seu melhor conteúdo.
Fóruns de Discussão:
Compartilhamento em redes sociais com aparência profissional com cartões personalizados, aumentando o engajamento e reduzindo as taxas de rejeição.
Comunidades Internacionais:
Detecção automática de idioma garante que os usuários vejam o conteúdo em seu idioma preferido, melhorando a acessibilidade.
Manutenção
Operação sem manutenção:
- Atualização automática do cache em atualizações de conteúdo
- Auto-recuperação em erros (nunca quebra seu site)
- Logs abrangentes para monitoramento
- Modo de depuração opcional para solução de problemas
Gerenciamento de cache (opcional):
# Console Rails
MetaGeneratorService.clear_all_cache
MetaGeneratorService.cache_stats
Solução de Problemas
Tags meta não aparecendo:
- Verifique se o plugin está habilitado em Admin → Plugins
- Verifique os logs:
./launcher logs app | grep RichMicrodata - Limpe o cache:
MetaGeneratorService.clear_all_cache
Trechos ricos não aparecendo no Google:
- O Google leva de 2 a 4 semanas para re-rastrear e atualizar
- Teste com Rich Results Test
- Verifique erros de validação no Search Console
Veja USAGE.md para solução de problemas detalhada.
Métricas de Desempenho
- Taxa de acerto do cache: 95%+ para fóruns típicos
- Tempo de resposta: < 5ms em cache, ~50ms novo
- Sobrecarga de memória: Mínima (usa Redis)
- Carga no banco de dados: Negligenciável (cache de 1 hora)
Roadmap
Versão atual: 2.0.0
Open Graph completo e Twitter Cards
Suporte completo ao Schema.org JSON-LD
Localização EN/RU
Codificação de URL para caracteres internacionais
Planejado:
- Pacotes de idiomas adicionais (ES, DE, FR)
- Suporte ao esquema de vídeo
- Esquema de evento para anúncios
- Esquema de produto para categorias de marketplace
Suporte
- Problemas: GitHub Issues
- Documentação: README.md
- Contribuição: CONTRIBUTING.md
Licença
Licença MIT — Software livre e de código aberto
Créditos
- Padrões: Schema.org, Open Graph Protocol, Twitter Cards
- Plataforma: Discourse
- Comunidade: Todos os contribuidores e usuários
Opcional: Instant View do Telegram
O repositório inclui regras de modelo de exemplo em TELEGRAM_IV_RULES.txt para criar modelos Instant View do Telegram bonitos. Use essas regras em instantview.telegram.org para fornecer uma experiência de leitura rápida e sem distrações para usuários que compartilham o conteúdo do seu fórum no Telegram.
Transforme a visibilidade do seu fórum hoje. Instale em menos de 5 minutos, veja resultados no Google em 2-4 semanas. 
para a Comunidade Discourse
!
