@edtools/cli 0.3.2 → 0.4.0

package/dist/index.d.ts

@@ -141,6 +141,43 @@ declare class AdapterRegistry {
     list(): string[];
 }
 
+interface GSCKeywordData {
+    query: string;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+    position: number;
+    url?: string;
+}
+interface ContentOpportunity {
+    keyword: string;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+    position: number;
+    potentialClicks: number;
+    priority: 'high' | 'medium' | 'low';
+    suggestedTitle: string;
+    reason: string;
+}
+interface GSCAnalysisResult {
+    totalQueries: number;
+    totalImpressions: number;
+    totalClicks: number;
+    avgCTR: number;
+    avgPosition: number;
+    opportunities: ContentOpportunity[];
+    topKeywords: GSCKeywordData[];
+    lowCTRPages: GSCKeywordData[];
+}
+interface OpportunityConfig {
+    minImpressions?: number;
+    minPosition?: number;
+    maxPosition?: number;
+    minPotentialClicks?: number;
+    limit?: number;
+}
+
 declare class ContentGenerator {
     private anthropic;
     private openai;
@@ -173,4 +210,4 @@ declare class HTMLAdapter implements Adapter {
     private escapeHtml;
 }
 
-export { type AIProvider, type Adapter, type AdapterConfig, AdapterRegistry, type BlogPostContent, type BlogPostMetadata, type CTAData, type CodeData, type ComparisonData, ContentGenerator, type ContentSection, type GenerateConfig, type GenerateResult, HTMLAdapter, type ListData, type ProductInfo, type RelatedPost, type SEOData, type SchemaOrgData };
+export { type AIProvider, type Adapter, type AdapterConfig, AdapterRegistry, type BlogPostContent, type BlogPostMetadata, type CTAData, type CodeData, type ComparisonData, ContentGenerator, type ContentOpportunity, type ContentSection, type GSCAnalysisResult, type GSCKeywordData, type GenerateConfig, type GenerateResult, HTMLAdapter, type ListData, type OpportunityConfig, type ProductInfo, type RelatedPost, type SEOData, type SchemaOrgData };

package/dist/integrations/gsc-csv-analyzer.d.ts

@@ -0,0 +1,5 @@
+import { GSCKeywordData, ContentOpportunity, GSCAnalysisResult, OpportunityConfig } from '../types/analytics.js';
+export declare function parseGSCCSV(filePath: string): Promise<GSCKeywordData[]>;
+export declare function analyzeGSCData(data: GSCKeywordData[], config?: OpportunityConfig): GSCAnalysisResult;
+export declare function saveOpportunities(opportunities: ContentOpportunity[], outputPath: string): Promise<void>;
+//# sourceMappingURL=gsc-csv-analyzer.d.ts.map

package/dist/integrations/gsc-csv-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsc-csv-analyzer.d.ts","sourceRoot":"","sources":["../../src/integrations/gsc-csv-analyzer.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAK/B,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAkC7E;AAKD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,EAAE,EACtB,MAAM,GAAE,iBAAsB,GAC7B,iBAAiB,CAkFnB;AAwBD,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,kBAAkB,EAAE,EACnC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/integrations/gsc-csv-analyzer.js

@@ -0,0 +1,110 @@
+import fs from 'fs-extra';
+import { parse } from 'csv-parse/sync';
+export async function parseGSCCSV(filePath) {
+    const content = await fs.readFile(filePath, 'utf-8');
+    const records = parse(content, {
+        columns: true,
+        skip_empty_lines: true,
+        cast: (value, context) => {
+            if (context.column === 'Clicks' || context.column === 'Impressions') {
+                return parseInt(value.replace(/,/g, ''), 10);
+            }
+            if (context.column === 'CTR') {
+                return parseFloat(value.replace('%', '')) / 100;
+            }
+            if (context.column === 'Position') {
+                return parseFloat(value);
+            }
+            return value;
+        },
+    });
+    const data = records.map((record) => ({
+        query: record['Top queries'] || record['Query'] || record['query'] || '',
+        impressions: record['Impressions'] || record['impressions'] || 0,
+        clicks: record['Clicks'] || record['clicks'] || 0,
+        ctr: record['CTR'] || record['ctr'] || 0,
+        position: record['Position'] || record['position'] || 0,
+        url: record['Top pages'] || record['Page'] || record['url'] || undefined,
+    }));
+    return data.filter((d) => d.query && d.impressions > 0);
+}
+export function analyzeGSCData(data, config = {}) {
+    const { minImpressions = 50, minPosition = 20, maxPosition = 100, minPotentialClicks = 10, limit = 10, } = config;
+    const totalQueries = data.length;
+    const totalImpressions = data.reduce((sum, d) => sum + d.impressions, 0);
+    const totalClicks = data.reduce((sum, d) => sum + d.clicks, 0);
+    const avgCTR = totalClicks / totalImpressions || 0;
+    const avgPosition = data.reduce((sum, d) => sum + d.position, 0) / totalQueries || 0;
+    const opportunities = data
+        .filter((d) => d.impressions >= minImpressions && d.position >= minPosition && d.position <= maxPosition)
+        .map((d) => {
+        const estimatedCTRTop10 = 0.15;
+        const potentialClicks = Math.round(d.impressions * estimatedCTRTop10 - d.clicks);
+        let priority = 'low';
+        if (d.impressions > 100 && potentialClicks > 20) {
+            priority = 'high';
+        }
+        else if (d.impressions > 50 && potentialClicks > 10) {
+            priority = 'medium';
+        }
+        const suggestedTitle = generateSuggestedTitle(d.query);
+        const reason = `${d.impressions} impressions at position ${d.position.toFixed(1)} → potential +${potentialClicks} clicks`;
+        return {
+            keyword: d.query,
+            impressions: d.impressions,
+            clicks: d.clicks,
+            ctr: d.ctr,
+            position: d.position,
+            potentialClicks,
+            priority,
+            suggestedTitle,
+            reason,
+        };
+    })
+        .filter((opp) => opp.potentialClicks >= minPotentialClicks)
+        .sort((a, b) => {
+        const priorityOrder = { high: 3, medium: 2, low: 1 };
+        const priorityDiff = priorityOrder[b.priority] - priorityOrder[a.priority];
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        return b.potentialClicks - a.potentialClicks;
+    })
+        .slice(0, limit);
+    const topKeywords = [...data]
+        .sort((a, b) => b.clicks - a.clicks)
+        .slice(0, 10);
+    const lowCTRPages = data
+        .filter((d) => d.position <= 20 && d.ctr < 0.02)
+        .sort((a, b) => a.ctr - b.ctr)
+        .slice(0, 10);
+    return {
+        totalQueries,
+        totalImpressions,
+        totalClicks,
+        avgCTR,
+        avgPosition,
+        opportunities,
+        topKeywords,
+        lowCTRPages,
+    };
+}
+function generateSuggestedTitle(keyword) {
+    const words = keyword.split(' ');
+    const capitalized = words
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+    const currentYear = new Date().getFullYear();
+    if (!capitalized.includes(currentYear.toString())) {
+        return `${capitalized}: Complete Guide ${currentYear}`;
+    }
+    return `${capitalized}: Complete Guide`;
+}
+export async function saveOpportunities(opportunities, outputPath) {
+    const data = {
+        generatedAt: new Date().toISOString(),
+        count: opportunities.length,
+        opportunities,
+    };
+    await fs.writeJson(outputPath, data, { spaces: 2 });
+}
+//# sourceMappingURL=gsc-csv-analyzer.js.map

package/dist/integrations/gsc-csv-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsc-csv-analyzer.js","sourceRoot":"","sources":["../../src/integrations/gsc-csv-analyzer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAWvC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAGrD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE;QAC7B,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,IAAI;QACtB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAEvB,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACpE,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAE7B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;YAClD,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAClC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC,CAAC;IAGH,MAAM,IAAI,GAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;QAC3D,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACxE,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;QAChE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjD,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACvD,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS;KACzE,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAKD,MAAM,UAAU,cAAc,CAC5B,IAAsB,EACtB,SAA4B,EAAE;IAE9B,MAAM,EACJ,cAAc,GAAG,EAAE,EACnB,WAAW,GAAG,EAAE,EAChB,WAAW,GAAG,GAAG,EACjB,kBAAkB,GAAG,EAAE,EACvB,KAAK,GAAG,EAAE,GACX,GAAG,MAAM,CAAC;IAGX,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,WAAW,GAAG,gBAAgB,IAAI,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,YAAY,IAAI,CAAC,CAAC;IAGrF,MAAM,aAAa,GAAyB,IAAI;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,cAAc,IAAI,CAAC,CAAC,QAAQ,IAAI,WAAW,IAAI,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC;SACxG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAGT,MAAM,iBAAiB,GAAG,IAAI,CAAC;QAC/B,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAGjF,IAAI,QAAQ,GAA8B,KAAK,CAAC;QAChD,IAAI,CAAC,CAAC,WAAW,GAAG,GAAG,IAAI,eAAe,GAAG,EAAE,EAAE,CAAC;YAChD,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,CAAC,WAAW,GAAG,EAAE,IAAI,eAAe,GAAG,EAAE,EAAE,CAAC;YACtD,QAAQ,GAAG,QAAQ,CAAC;QACtB,CAAC;QAGD,MAAM,cAAc,GAAG,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAGvD,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,4BAA4B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,eAAe,SAAS,CAAC;QAE1H,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,KAAK;YAChB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,eAAe;YACf,QAAQ;YACR,cAAc;YACd,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,IAAI,kBAAkB,CAAC;SAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAEb,MAAM,aAAa,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO,YAAY,CAAC;QAC5C,OAAO,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;IAC/C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAGnB,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;SACnC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAGhB,MAAM,WAAW,GAAG,IAAI;SACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;SAC/C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO;QACL,YAAY;QACZ,gBAAgB;QAChB,WAAW;QACX,MAAM;QACN,WAAW;QACX,aAAa;QACb,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC;AAKD,SAAS,sBAAsB,CAAC,OAAe;IAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,KAAK;SACtB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;IAGb,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;QAClD,OAAO,GAAG,WAAW,oBAAoB,WAAW,EAAE,CAAC;IACzD,CAAC;IAED,OAAO,GAAG,WAAW,kBAAkB,CAAC;AAC1C,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,aAAmC,EACnC,UAAkB;IAElB,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,KAAK,EAAE,aAAa,CAAC,MAAM;QAC3B,aAAa;KACd,CAAC;IAEF,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/templates/blog-post.html.ejs

@@ -0,0 +1,305 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title><%= metadata.title %></title>
+  <meta name="description" content="<%= metadata.description %>">
+  <meta name="keywords" content="<%= metadata.keywords.join(', ') %>">
+  <meta name="author" content="<%= metadata.author %>">
+  <meta name="date" content="<%= metadata.datePublished %>">
+
+  <!-- Open Graph / Social Media -->
+  <meta property="og:type" content="article">
+  <meta property="og:title" content="<%= metadata.title %>">
+  <meta property="og:description" content="<%= metadata.description %>">
+  <meta property="article:published_time" content="<%= metadata.datePublished %>">
+  <meta property="article:author" content="<%= metadata.author %>">
+  <meta property="article:section" content="<%= metadata.category %>">
+  <% metadata.keywords.forEach(keyword => { %>
+  <meta property="article:tag" content="<%= keyword %>">
+  <% }) %>
+
+  <!-- Schema.org structured data -->
+  <script type="application/ld+json">
+<%- schemaOrg %>
+  </script>
+
+  <style>
+    :root {
+      --primary-color: #2563eb;
+      --text-color: #1f2937;
+      --text-light: #6b7280;
+      --border-color: #e5e7eb;
+      --bg-light: #f9fafb;
+    }
+
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+      line-height: 1.6;
+      color: var(--text-color);
+      max-width: 800px;
+      margin: 0 auto;
+      padding: 2rem 1rem;
+    }
+
+    article {
+      background: white;
+    }
+
+    h1 {
+      font-size: 2.5rem;
+      font-weight: 700;
+      line-height: 1.2;
+      margin-bottom: 1rem;
+      color: var(--text-color);
+    }
+
+    h2 {
+      font-size: 1.875rem;
+      font-weight: 600;
+      margin-top: 2.5rem;
+      margin-bottom: 1rem;
+      color: var(--text-color);
+    }
+
+    h3 {
+      font-size: 1.5rem;
+      font-weight: 600;
+      margin-top: 2rem;
+      margin-bottom: 0.75rem;
+      color: var(--text-color);
+    }
+
+    h4 {
+      font-size: 1.25rem;
+      font-weight: 600;
+      margin-top: 1.5rem;
+      margin-bottom: 0.5rem;
+      color: var(--text-color);
+    }
+
+    p {
+      margin-bottom: 1rem;
+      color: var(--text-color);
+    }
+
+    a {
+      color: var(--primary-color);
+      text-decoration: none;
+    }
+
+    a:hover {
+      text-decoration: underline;
+    }
+
+    .intro {
+      font-size: 1.125rem;
+      color: var(--text-light);
+      margin-bottom: 2rem;
+      padding-bottom: 2rem;
+      border-bottom: 1px solid var(--border-color);
+    }
+
+    section {
+      margin-bottom: 2.5rem;
+    }
+
+    .comparison-table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 1.5rem 0;
+      font-size: 0.9375rem;
+    }
+
+    .comparison-table thead {
+      background: var(--bg-light);
+    }
+
+    .comparison-table th,
+    .comparison-table td {
+      padding: 0.75rem 1rem;
+      text-align: left;
+      border: 1px solid var(--border-color);
+    }
+
+    .comparison-table th {
+      font-weight: 600;
+      color: var(--text-color);
+    }
+
+    .comparison-table tbody tr:hover {
+      background: var(--bg-light);
+    }
+
+    .content-list {
+      margin: 1.5rem 0;
+      padding-left: 1.5rem;
+    }
+
+    .content-list li {
+      margin-bottom: 1rem;
+    }
+
+    .content-list strong {
+      color: var(--text-color);
+      display: block;
+      margin-bottom: 0.25rem;
+    }
+
+    .code-block {
+      margin: 1.5rem 0;
+      background: var(--bg-light);
+      border: 1px solid var(--border-color);
+      border-radius: 0.375rem;
+      overflow: hidden;
+    }
+
+    .code-caption {
+      padding: 0.5rem 1rem;
+      background: #e5e7eb;
+      font-size: 0.875rem;
+      font-weight: 600;
+      border-bottom: 1px solid var(--border-color);
+    }
+
+    .code-block pre {
+      padding: 1rem;
+      overflow-x: auto;
+    }
+
+    .code-block code {
+      font-family: 'Monaco', 'Courier New', monospace;
+      font-size: 0.875rem;
+      line-height: 1.5;
+    }
+
+    .conclusion {
+      margin-top: 3rem;
+      padding-top: 2rem;
+      border-top: 1px solid var(--border-color);
+    }
+
+    .cta {
+      margin-top: 3rem;
+      padding: 2rem;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      border-radius: 0.5rem;
+      text-align: center;
+    }
+
+    .cta a {
+      display: inline-block;
+      padding: 1rem 2rem;
+      background: white;
+      color: var(--primary-color);
+      font-weight: 600;
+      font-size: 1.125rem;
+      border-radius: 0.375rem;
+      transition: transform 0.2s;
+    }
+
+    .cta a:hover {
+      transform: translateY(-2px);
+      text-decoration: none;
+      box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+    }
+
+    .related-posts {
+      margin-top: 4rem;
+      padding-top: 2rem;
+      border-top: 2px solid var(--border-color);
+    }
+
+    .related-posts h3 {
+      margin-top: 0;
+      margin-bottom: 1.5rem;
+    }
+
+    .related-posts ul {
+      list-style: none;
+      padding: 0;
+    }
+
+    .related-posts li {
+      margin-bottom: 0.75rem;
+    }
+
+    .related-posts a {
+      font-weight: 500;
+    }
+
+    .seo-badge {
+      display: inline-block;
+      padding: 0.25rem 0.75rem;
+      background: <%= seoScore >= 80 ? '#10b981' : seoScore >= 60 ? '#f59e0b' : '#ef4444' %>;
+      color: white;
+      border-radius: 9999px;
+      font-size: 0.875rem;
+      font-weight: 600;
+      margin-bottom: 1rem;
+    }
+  </style>
+</head>
+<body>
+  <article>
+    <!-- SEO Badge (hidden by default, can be shown in preview mode) -->
+    <!-- <div class="seo-badge">SEO Score: <%= seoScore %>/100</div> -->
+
+    <h1><%= metadata.title %></h1>
+
+    <div class="intro">
+      <%- intro %>
+    </div>
+
+    <% sections.forEach(section => { %>
+      <section>
+        <h<%= section.level %>><%= section.heading %></h<%= section.level %>>
+        <%- section.content %>
+      </section>
+    <% }) %>
+
+    <div class="conclusion">
+      <%- conclusion %>
+    </div>
+
+    <div class="cta">
+      <a href="<%= cta.url %>"><%= cta.text %></a>
+    </div>
+
+    <% if (relatedPosts && relatedPosts.length > 0) { %>
+      <div class="related-posts">
+        <h3>Artículos relacionados</h3>
+        <ul>
+          <% relatedPosts.forEach(post => { %>
+            <li>
+              <a href="<%= post.url %>"><%= post.title %></a>
+              <% if (post.excerpt) { %>
+                <p style="color: var(--text-light); font-size: 0.875rem; margin-top: 0.25rem;">
+                  <%= post.excerpt %>
+                </p>
+              <% } %>
+            </li>
+          <% }) %>
+        </ul>
+      </div>
+    <% } %>
+  </article>
+
+  <!-- AI-friendly metadata in comments for LLM parsing -->
+  <!--
+  METADATA:
+  - Title: <%= metadata.title %>
+  - Category: <%= metadata.category %>
+  - Keywords: <%= metadata.keywords.join(', ') %>
+  - Published: <%= metadata.datePublished %>
+  - SEO Score: <%= seoScore %>/100
+  -->
+</body>
+</html>

package/dist/types/analytics.d.ts

@@ -0,0 +1,37 @@
+export interface GSCKeywordData {
+    query: string;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+    position: number;
+    url?: string;
+}
+export interface ContentOpportunity {
+    keyword: string;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+    position: number;
+    potentialClicks: number;
+    priority: 'high' | 'medium' | 'low';
+    suggestedTitle: string;
+    reason: string;
+}
+export interface GSCAnalysisResult {
+    totalQueries: number;
+    totalImpressions: number;
+    totalClicks: number;
+    avgCTR: number;
+    avgPosition: number;
+    opportunities: ContentOpportunity[];
+    topKeywords: GSCKeywordData[];
+    lowCTRPages: GSCKeywordData[];
+}
+export interface OpportunityConfig {
+    minImpressions?: number;
+    minPosition?: number;
+    maxPosition?: number;
+    minPotentialClicks?: number;
+    limit?: number;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/types/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAKD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/analytics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analytics.js.map

package/dist/types/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from './content.js';
 export * from './adapter.js';
+export * from './analytics.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -1,3 +1,4 @@
 export * from './content.js';
 export * from './adapter.js';
+export * from './analytics.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/ui/banner.d.ts

@@ -0,0 +1,7 @@
+export declare function generateBanner(): string;
+export declare function showWelcome(): void;
+export declare function successBox(message: string): string;
+export declare function errorBox(message: string): string;
+export declare function infoBox(title: string, content: string): string;
+export declare function warningBox(message: string): string;
+//# sourceMappingURL=banner.d.ts.map

package/dist/ui/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,IAAI,MAAM,CAsBvC;AAKD,wBAAgB,WAAW,IAAI,IAAI,CAYlC;AAiBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOlD;AAKD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhD;AAKD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9D;AAKD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOlD"}

package/dist/ui/banner.js

@@ -0,0 +1,76 @@
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+import boxen from 'boxen';
+import chalk from 'chalk';
+export function generateBanner() {
+    const asciiArt = figlet.textSync('edtools', {
+        font: 'ANSI Shadow',
+        horizontalLayout: 'default',
+        verticalLayout: 'default',
+    });
+    const coloredAscii = gradient(['#00D9FF', '#00FF9F'])(asciiArt);
+    const tagline = chalk.gray('AI-Powered Content Marketing CLI');
+    const version = chalk.dim(`v${getVersion()}`);
+    const content = `${coloredAscii}\n\n${tagline}  ${version}`;
+    return boxen(content, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'cyan',
+        dimBorder: false,
+    });
+}
+export function showWelcome() {
+    console.log(generateBanner());
+    console.log('');
+    console.log(chalk.bold.cyan('  Quick Start:'));
+    console.log(chalk.gray('  ────────────'));
+    console.log('');
+    console.log(`  ${chalk.cyan('edtools init')}          ${chalk.gray('Initialize your project')}`);
+    console.log(`  ${chalk.cyan('edtools generate')}      ${chalk.gray('Generate SEO-optimized posts')}`);
+    console.log(`  ${chalk.cyan('edtools analyze')}       ${chalk.gray('Analyze Google Search Console CSV')}`);
+    console.log('');
+    console.log(chalk.gray('  Run ') + chalk.cyan('edtools --help') + chalk.gray(' for all commands'));
+    console.log('');
+}
+function getVersion() {
+    try {
+        return '0.4.0';
+    }
+    catch {
+        return 'dev';
+    }
+}
+export function successBox(message) {
+    return boxen(chalk.green('✓ ') + message, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'green',
+    });
+}
+export function errorBox(message) {
+    return boxen(chalk.red('✗ ') + message, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'red',
+    });
+}
+export function infoBox(title, content) {
+    return boxen(`${chalk.cyan.bold(title)}\n\n${content}`, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'cyan',
+    });
+}
+export function warningBox(message) {
+    return boxen(chalk.yellow('⚠ ') + message, {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow',
+    });
+}
+//# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"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"}