@jjlmoya/utils-tools 1.1.0

package/src/tool/seo-content-optimizer/i18n/es.ts

@@ -0,0 +1,136 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { SeoContentOptimizerUI } from '../ui';
+
+const faqData = [
+  {
+    question: '¿Cómo ayuda esta herramienta a mi posicionamiento SEO?',
+    answer: 'Al analizar la densidad de keywords y la legibilidad de las frases, aseguras que tu contenido sea fácil de entender para los usuarios y relevante para los buscadores, evitando penalizaciones por sobreoptimización.',
+  },
+  {
+    question: '¿Qué aspectos técnicos del HTML analiza?',
+    answer: 'Verifica la existencia y unicidad de la etiqueta H1, la presencia de subencabezados H2/H3 y los atributos alt en las imágenes.',
+  },
+  {
+    question: '¿Mis textos se guardan en el servidor?',
+    answer: 'No. El análisis se realiza 100% de forma local en tu navegador. Tu contenido nunca sale de tu ordenador.',
+  },
+  {
+    question: '¿Es compatible con los criterios de Yoast SEO?',
+    answer: 'Sí, implementamos criterios similares: longitud de frases, distribución de párrafos y jerarquía de encabezados.',
+  },
+];
+
+const howToData = [
+  { name: 'Escribe o pega tu texto', text: 'Introduce el contenido que deseas analizar en el área de texto principal.' },
+  { name: 'Revisa el checklist de optimización', text: 'Comprueba las alertas de longitud, legibilidad y densidad de keywords en el panel lateral.' },
+  { name: 'Analiza el HTML técnico', text: 'Cambia a la pestaña de análisis técnico para verificar etiquetas H1, alts de imagen y estructura de metadatos.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Cómo optimizar contenido para SEO',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Optimizador de Contenido SEO',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Analiza la densidad de palabras clave, legibilidad y estructura técnica HTML de tus textos en tiempo real, sin enviar datos a ningún servidor.',
+};
+
+const ui: SeoContentOptimizerUI = {
+  tabText: 'Análisis de Texto',
+  tabHtml: 'Análisis HTML Técnico',
+  textareaPlaceholder: 'Escribe tu texto o pega tu código HTML aquí...',
+  statsChars: 'Caracteres',
+  statsWords: 'Palabras',
+  statsReading: 'Lectura',
+  statsSentences: 'Frases',
+  checklistTitle: 'Checklist de Optimización',
+  keywordsTitle: 'Densidad de Keywords',
+  technicalTitle: 'Análisis Técnico HTML',
+  h1Label: 'H1 Detectados',
+  linksLabel: 'Enlaces (a)',
+  imgsLabel: 'Imágenes (img)',
+  altsLabel: 'Alts faltantes',
+  emptyState: 'Sin datos',
+  analyzing: 'Analizando...',
+  checkInsufficient: 'Longitud insuficiente (< 300 pal.)',
+  checkPillar: 'Contenido pilar excelente (> 900 pal.)',
+  checkGoodLength: 'Longitud buena para SEO',
+  checkLongSentences: 'Demasiadas frases largas (> 25% del texto)',
+  checkGoodReadability: 'Legibilidad de frases óptima',
+  checkLongParagraphs: 'Divide párrafos muy largos (> 150 pal.)',
+  checkMissingH1: 'Falta etiqueta H1',
+  checkMultipleH1: 'Múltiples H1 detectados',
+  checkMissingH2: 'Faltan subencabezados (H2)',
+  checkMissingTitle: 'Falta etiqueta de título meta',
+  stopWords: JSON.stringify(['el', 'la', 'los', 'las', 'un', 'una', 'unos', 'unas', 'y', 'o', 'u', 'en', 'de', 'del', 'por', 'para', 'con', 'sin', 'sobre', 'que', 'si', 'no', 'es', 'son', 'fue', 'era', 'esta', 'esto', 'estos', 'estas', 'a', 'ante', 'bajo', 'contra', 'desde', 'durante', 'entre', 'hacia', 'hasta', 'mediante', 'tras']),
+};
+
+export const content: ToolLocaleContent<SeoContentOptimizerUI> = {
+  slug: 'optimizador-contenido-seo',
+  title: 'Optimizador de Contenido SEO',
+  description: 'Analiza la densidad de palabras clave, legibilidad y estructura técnica HTML de tus textos en tiempo real. Herramienta SEO privada y gratuita.',
+  ui,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Referencias',
+  bibliography: [
+    { name: 'Guía de inicio de SEO de Google', url: 'https://developers.google.com/search/docs/fundamentals/seo-starter-guide' },
+    { name: 'Criterios de legibilidad Yoast SEO', url: 'https://yoast.com/what-is-readability/' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Optimizador de Contenido SEO: Keywords, Legibilidad y Estructura' },
+    {
+      type: 'paragraph',
+      html: 'La calidad del contenido ya no se mide solo por las palabras clave que incluyes, sino por cómo estructuras tu información para que sea digerible tanto para humanos como para los rastreadores de Google. Nuestra herramienta de <strong>análisis SEO en tiempo real</strong> te ofrece control total sobre la densidad de keywords, la legibilidad de tus párrafos y los elementos técnicos fundamentales del HTML.',
+    },
+    { type: 'title', level: 3, text: 'Densidad de Keywords y Relevancia Semántica' },
+    {
+      type: 'paragraph',
+      html: 'La <strong>densidad de palabras clave</strong> indica con qué frecuencia aparece un término en comparación con el resto del texto. Un exceso activa los filtros de <em>keyword stuffing</em>, mientras que una densidad muy baja dificulta que los buscadores identifiquen el tema central de tu artículo.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Análisis de relevancia:</strong> Identifica si las palabras más repetidas coinciden con tu intención de búsqueda.',
+        '<strong>Prevención de penalizaciones:</strong> Evita repetir excesivamente términos que puedan dar imagen de spam.',
+        '<strong>Optimización semántica:</strong> Ayuda a encontrar equilibrio entre términos técnicos y lenguaje natural.',
+      ],
+    },
+    { type: 'title', level: 3, text: 'Legibilidad al Estilo Yoast' },
+    {
+      type: 'paragraph',
+      html: 'La legibilidad es un factor de ranking indirecto pero crucial. Si un usuario abandona la página porque los párrafos son bloques interminables, tu <em>Dwell Time</em> bajará. El analizador detecta frases largas (más de 20 palabras), párrafos de más de 150 palabras y la presencia de subencabezados.',
+    },
+    {
+      type: 'tip',
+      title: 'Tiempo de lectura',
+      html: 'La mayoría de los usuarios decide si leer un artículo en menos de 10 segundos. Conocer el tiempo estimado de lectura (calculado sobre una media de 200 palabras por minuto) ayuda a reducir la tasa de rebote ajustando las expectativas del lector.',
+    },
+    { type: 'title', level: 3, text: 'Análisis Técnico HTML' },
+    {
+      type: 'paragraph',
+      html: 'Pega tu código fuente para verificar elementos clave: unicidad del <strong>H1</strong>, presencia de subencabezados H2/H3, imágenes sin atributo <code>alt</code> y existencia de la etiqueta <code>title</code>. Todo el procesamiento ocurre en tu navegador sin enviar datos a ningún servidor.',
+    },
+  ],
+};

package/src/tool/seo-content-optimizer/i18n/fr.ts

@@ -0,0 +1,136 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { SeoContentOptimizerUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'Comment cet outil améliore-t-il mon référencement SEO ?',
+    answer: 'En analysant la densité des mots-clés et la lisibilité des phrases, vous vous assurez que votre contenu est compréhensible pour les utilisateurs et pertinent pour les moteurs de recherche, en évitant les pénalités de sur-optimisation.',
+  },
+  {
+    question: "Quels éléments HTML l'analyse technique vérifie-t-elle ?",
+    answer: "Elle vérifie l'existence et l'unicité de la balise H1, la présence de sous-titres H2/H3 et les attributs alt sur les images.",
+  },
+  {
+    question: 'Mon contenu est-il stocké sur un serveur ?',
+    answer: "Non. L'analyse s'effectue à 100 % localement dans votre navigateur. Votre contenu ne quitte jamais votre ordinateur.",
+  },
+  {
+    question: 'Est-il compatible avec les critères Yoast SEO ?',
+    answer: "Oui, nous appliquons des critères similaires à Yoast : longueur des phrases, distribution des paragraphes et hiérarchie des titres.",
+  },
+];
+
+const howToData = [
+  { name: 'Écrivez ou collez votre texte', text: 'Entrez le contenu que vous souhaitez analyser dans la zone de texte principale.' },
+  { name: "Consultez la checklist d'optimisation", text: 'Vérifiez les alertes de longueur, de lisibilité et de densité de mots-clés dans le panneau latéral.' },
+  { name: 'Analysez le HTML technique', text: "Passez à l'onglet d'analyse technique pour vérifier les balises H1, les alts d'images et la structure des métadonnées." },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Comment optimiser le contenu pour le SEO',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Optimiseur de Contenu SEO',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: "Analysez la densité des mots-clés, la lisibilité et la structure HTML technique de vos textes en temps réel, sans envoyer de données à un serveur.",
+};
+
+const ui: SeoContentOptimizerUI = {
+  tabText: 'Analyse de Texte',
+  tabHtml: 'Analyse HTML Technique',
+  textareaPlaceholder: 'Écrivez votre texte ou collez votre code HTML ici...',
+  statsChars: 'Caractères',
+  statsWords: 'Mots',
+  statsReading: 'Lecture',
+  statsSentences: 'Phrases',
+  checklistTitle: "Checklist d'Optimisation",
+  keywordsTitle: 'Densité de Mots-Clés',
+  technicalTitle: 'Analyse HTML Technique',
+  h1Label: 'H1 Détectés',
+  linksLabel: 'Liens (a)',
+  imgsLabel: 'Images (img)',
+  altsLabel: 'Alts manquants',
+  emptyState: 'Aucune donnée',
+  analyzing: 'Analyse...',
+  checkInsufficient: 'Longueur insuffisante (< 300 mots)',
+  checkPillar: 'Excellent contenu pilier (> 900 mots)',
+  checkGoodLength: 'Bonne longueur pour le SEO',
+  checkLongSentences: 'Trop de phrases longues (> 25 % du texte)',
+  checkGoodReadability: 'Lisibilité des phrases optimale',
+  checkLongParagraphs: 'Divisez les paragraphes trop longs (> 150 mots)',
+  checkMissingH1: 'Balise H1 manquante',
+  checkMultipleH1: 'Plusieurs balises H1 détectées',
+  checkMissingH2: 'Sous-titres (H2) manquants',
+  checkMissingTitle: 'Balise title méta manquante',
+  stopWords: JSON.stringify(['le', 'la', 'les', 'un', 'une', 'des', 'et', 'ou', 'mais', 'en', 'de', 'du', 'au', 'aux', 'par', 'pour', 'avec', 'sans', 'sur', 'que', 'qui', 'si', 'non', 'est', 'sont', 'ce', 'cet', 'cette', 'ces', 'il', 'elle', 'ils', 'elles', 'nous', 'vous', 'je', 'me', 'tu', 'se', 'y', 'dont', 'pas', 'plus', 'ne']),
+};
+
+export const content: ToolLocaleContent<SeoContentOptimizerUI> = {
+  slug: 'optimiseur-contenu-seo',
+  title: 'Optimiseur de Contenu SEO',
+  description: "Analysez la densité des mots-clés, la lisibilité et la structure HTML technique de vos textes en temps réel. Outil SEO gratuit et privé.",
+  ui,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Références',
+  bibliography: [
+    { name: 'Guide de démarrage SEO de Google', url: 'https://developers.google.com/search/docs/fundamentals/seo-starter-guide' },
+    { name: 'Critères de lisibilité Yoast SEO', url: 'https://yoast.com/what-is-readability/' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Optimiseur de Contenu SEO : Mots-Clés, Lisibilité et Structure' },
+    {
+      type: 'paragraph',
+      html: "La qualité du contenu ne se mesure plus seulement aux mots-clés inclus, mais à la façon dont vous structurez l'information pour qu'elle soit compréhensible à la fois par les humains et les robots de Google. Notre outil d'<strong>analyse SEO en temps réel</strong> vous offre un contrôle total sur la densité des mots-clés, la lisibilité des paragraphes et les éléments techniques HTML fondamentaux.",
+    },
+    { type: 'title', level: 3, text: 'Densité de Mots-Clés et Pertinence Sémantique' },
+    {
+      type: 'paragraph',
+      html: 'La <strong>densité de mots-clés</strong> indique la fréquence d\'apparition d\'un terme par rapport au reste du texte. Un excès déclenche les filtres de <em>keyword stuffing</em>, tandis qu\'une densité trop faible peut rendre difficile l\'identification du sujet principal de votre article par les moteurs de recherche.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Analyse de pertinence :</strong> Identifiez si les mots les plus répétés correspondent à votre intention de recherche.',
+        '<strong>Prévention des pénalités :</strong> Évitez de répéter excessivement des termes qui pourraient paraître indésirables.',
+        "<strong>Optimisation sémantique :</strong> Trouvez l'équilibre entre termes techniques et langage naturel.",
+      ],
+    },
+    { type: 'title', level: 3, text: 'Lisibilité à la Manière Yoast' },
+    {
+      type: 'paragraph',
+      html: 'La lisibilité est un facteur de classement indirect mais crucial. Si les utilisateurs quittent la page parce que les paragraphes sont de longs blocs de texte, votre <em>Dwell Time</em> diminuera. L\'analyseur détecte les phrases longues (plus de 20 mots), les paragraphes de plus de 150 mots et vérifie la présence de sous-titres.',
+    },
+    {
+      type: 'tip',
+      title: 'Temps de lecture',
+      html: 'La plupart des utilisateurs décident de lire un article en moins de 10 secondes. Connaître le temps de lecture estimé (calculé sur une moyenne de 200 mots par minute) aide à réduire le taux de rebond en ajustant les attentes du lecteur.',
+    },
+    { type: 'title', level: 3, text: 'Analyse HTML Technique' },
+    {
+      type: 'paragraph',
+      html: 'Collez votre code source pour vérifier les éléments clés : unicité du <strong>H1</strong>, présence de sous-titres H2/H3, images sans attribut <code>alt</code> et existence de la balise <code>title</code>. Tout le traitement se fait dans votre navigateur sans envoyer de données à un serveur.',
+    },
+  ],
+};

package/src/tool/seo-content-optimizer/index.ts

@@ -0,0 +1,22 @@
+import type { ToolDefinition, ToolsToolEntry } from '../../types';
+import type { SeoContentOptimizerUI } from './ui';
+import SeoContentOptimizerComponent from './component.astro';
+import SeoContentOptimizerSEO from './seo.astro';
+import SeoContentOptimizerBibliography from './bibliography.astro';
+
+export const seoContentOptimizer: ToolsToolEntry<SeoContentOptimizerUI> = {
+  id: 'seo-content-optimizer',
+  icons: { bg: 'mdi:file-search', fg: 'mdi:shield-check-outline' },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+  },
+};
+
+export const SEO_CONTENT_OPTIMIZER_TOOL: ToolDefinition = {
+  entry: seoContentOptimizer,
+  Component: SeoContentOptimizerComponent,
+  SEOComponent: SeoContentOptimizerSEO,
+  BibliographyComponent: SeoContentOptimizerBibliography,
+};

package/src/tool/seo-content-optimizer/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { seoContentOptimizer } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await seoContentOptimizer.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/seo-content-optimizer/ui.ts

@@ -0,0 +1,29 @@
+export interface SeoContentOptimizerUI extends Record<string, string> {
+  tabText: string;
+  tabHtml: string;
+  textareaPlaceholder: string;
+  statsChars: string;
+  statsWords: string;
+  statsReading: string;
+  statsSentences: string;
+  checklistTitle: string;
+  keywordsTitle: string;
+  technicalTitle: string;
+  h1Label: string;
+  linksLabel: string;
+  imgsLabel: string;
+  altsLabel: string;
+  emptyState: string;
+  analyzing: string;
+  checkInsufficient: string;
+  checkPillar: string;
+  checkGoodLength: string;
+  checkLongSentences: string;
+  checkGoodReadability: string;
+  checkLongParagraphs: string;
+  checkMissingH1: string;
+  checkMultipleH1: string;
+  checkMissingH2: string;
+  checkMissingTitle: string;
+  stopWords: string;
+}

package/src/tool/speed-reader/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { speedReader } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await speedReader.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}