@edtools/cli 0.1.0

package/README.md

@@ -0,0 +1,219 @@
+# @edtools/cli
+
+> Generate SEO-optimized content for LLM discovery
+
+Make your product discoverable by AI assistants like Claude and ChatGPT through semantic search and SEO-optimized static pages.
+
+## Features
+
+- ✅ **Framework Agnostic** - Works with HTML, Next.js, and more
+- ✅ **AI-Powered** - Uses Claude to generate high-quality content
+- ✅ **SEO Optimized** - Built-in SEO scoring and Schema.org markup
+- ✅ **Local Processing** - No centralized database, everything runs locally
+- ✅ **Anti-Spam Safeguards** - Prevents Google penalties with rate limiting
+- ✅ **Extensible** - Plugin system for custom adapters
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install -g @edtools/cli
+```
+
+### Setup
+
+```bash
+cd your-project
+edtools init
+```
+
+This will:
+1. Analyze your landing page
+2. Create `edtools.config.js`
+3. Prompt for product information
+
+### Generate Content
+
+```bash
+# Set your Anthropic API key
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Generate 3 blog posts
+edtools generate
+```
+
+## How It Works
+
+```
+Your Landing Page
+      ↓
+   edtools init (analyzes & creates config)
+      ↓
+   edtools generate (creates blog posts)
+      ↓
+Static HTML files optimized for:
+  - Google SEO
+  - AI crawlers (Claude, ChatGPT)
+  - Schema.org markup
+  - llms.txt format
+```
+
+## CLI Commands
+
+### `edtools init`
+
+Initialize edtools in your project.
+
+```bash
+edtools init [options]
+
+Options:
+  -p, --path <path>  Project path (default: current directory)
+```
+
+### `edtools generate`
+
+Generate SEO-optimized blog posts.
+
+```bash
+edtools generate [options]
+
+Options:
+  -n, --posts <number>       Number of posts (default: 3, max: 10)
+  -t, --topics <topics...>   Specific topics to write about
+  -o, --output <dir>         Output directory (default: ./blog)
+  --api-key <key>            Anthropic API key
+```
+
+**Example:**
+
+```bash
+edtools generate -n 5 -o ./content/blog
+```
+
+### `edtools config`
+
+View or set configuration.
+
+```bash
+edtools config [options]
+
+Options:
+  --set-api-key <key>  Set Anthropic API key
+```
+
+## Configuration
+
+The `edtools.config.js` file contains your product information:
+
+```javascript
+module.exports = {
+  product: {
+    name: "My Product",
+    tagline: "One-line description",
+    description: "Longer description...",
+    category: "productivity",
+    websiteUrl: "https://myproduct.com",
+    pricingModel: "freemium",
+    features: [
+      "Feature 1",
+      "Feature 2",
+    ],
+  },
+
+  content: {
+    outputDir: './blog',
+    generateBlog: true,
+  },
+
+  seo: {
+    siteMapPath: './sitemap.xml',
+    robotsPath: './robots.txt',
+    allowAICrawlers: true,
+  },
+};
+```
+
+## Architecture
+
+### Framework Agnostic Design
+
+Edtools uses a 3-layer architecture:
+
+1. **Core Layer** - Generates content in universal JSON format
+2. **Adapter Layer** - Converts JSON to framework-specific code
+3. **Template Layer** - Renders final output
+
+**Current Adapters:**
+- ✅ HTML (static)
+- 🔄 Next.js (coming in v1.1)
+- 🔄 Markdown (coming in v1.1)
+
+### Avoiding Google Penalties
+
+Edtools includes safeguards to prevent spam detection:
+
+- **Rate Limiting**: Maximum 10 posts per run
+- **Spacing Recommendations**: Warns if generating too quickly
+- **Human Review**: Generated content requires review before publishing
+- **SEO Scoring**: Validates content quality
+- **No Keyword Stuffing**: Natural language generation
+
+## Best Practices
+
+1. **Generate Slowly**: 3-5 posts per week maximum
+2. **Review Content**: Always add personal experience/expertise
+3. **Space Publications**: Wait 3-7 days between batches
+4. **Verify Facts**: Check all statistics and claims
+5. **Add Examples**: Include real-world use cases
+
+## API Usage (Programmatic)
+
+```typescript
+import { ContentGenerator } from '@edtools/cli';
+
+const generator = new ContentGenerator(apiKey);
+
+const result = await generator.generate({
+  productInfo: {
+    name: "My Product",
+    category: "productivity",
+    // ...
+  },
+  outputDir: './blog',
+  count: 3,
+});
+```
+
+## Requirements
+
+- Node.js 18+
+- Anthropic API key ([get one here](https://console.anthropic.com/))
+
+## Roadmap
+
+- [ ] **v1.1**: MCP Server for Claude Code integration
+- [ ] **v1.1**: Next.js adapter
+- [ ] **v1.1**: Markdown adapter
+- [ ] **v1.2**: Local embeddings for duplicate detection
+- [ ] **v1.3**: Shopify adapter
+- [ ] **v2.0**: Dashboard web interface
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT © Edtools Team
+
+## Links
+
+- **Documentation**: [https://docs.edtools.dev](https://docs.edtools.dev)
+- **GitHub**: [https://github.com/edtools/cli](https://github.com/edtools/cli)
+- **Issues**: [https://github.com/edtools/cli/issues](https://github.com/edtools/cli/issues)
+
+---
+
+**Made with ❤️ to help products get discovered by AI assistants**

package/bin/edtools.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// Entry point for the edtools CLI
+// This file will be linked to node_modules/.bin/edtools
+
+import('../dist/cli/index.js').catch((err) => {
+  console.error('Failed to load edtools CLI:', err);
+  process.exit(1);
+});

package/dist/adapters/html/index.d.ts

@@ -0,0 +1,18 @@
+import { Adapter, BlogPostContent } from '../../types/index.js';
+export declare class HTMLAdapter implements Adapter {
+    name: string;
+    private templatePath;
+    constructor();
+    detect(projectPath: string): Promise<boolean>;
+    render(content: BlogPostContent): Promise<string>;
+    write(output: string, outputPath: string): Promise<void>;
+    getFileExtension(): string;
+    transformPath(basePath: string): string;
+    private markdownToHTML;
+    private renderSectionContent;
+    private renderComparisonTable;
+    private renderList;
+    private renderCode;
+    private escapeHtml;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/html/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/html/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEhE,qBAAa,WAAY,YAAW,OAAO;IACzC,IAAI,SAAU;IACd,OAAO,CAAC,YAAY,CAAS;;IAOvB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7C,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BjD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9D,gBAAgB,IAAI,MAAM;IAI1B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;YAWzB,cAAc;YAOd,oBAAoB;IAsBlC,OAAO,CAAC,qBAAqB;IAiC7B,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,UAAU;CAUnB"}

package/dist/adapters/html/index.js

@@ -0,0 +1,132 @@
+import fs from 'fs-extra';
+import path from 'path';
+import ejs from 'ejs';
+import { marked } from 'marked';
+export class HTMLAdapter {
+    name = 'html';
+    templatePath;
+    constructor() {
+        this.templatePath = path.join(__dirname, 'templates', 'blog-post.html.ejs');
+    }
+    async detect(projectPath) {
+        try {
+            const files = await fs.readdir(projectPath);
+            const hasHtml = files.some(f => f.endsWith('.html'));
+            const hasIndexHtml = await fs.pathExists(path.join(projectPath, 'index.html'));
+            return hasHtml || hasIndexHtml;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async render(content) {
+        const template = await fs.readFile(this.templatePath, 'utf-8');
+        const templateData = {
+            metadata: content.metadata,
+            schemaOrg: JSON.stringify(content.schemaOrg, null, 2),
+            intro: await this.markdownToHTML(content.content.intro),
+            sections: await Promise.all(content.content.sections.map(async (section) => ({
+                ...section,
+                content: await this.renderSectionContent(section),
+            }))),
+            conclusion: await this.markdownToHTML(content.content.conclusion),
+            cta: content.content.cta,
+            relatedPosts: content.relatedPosts || [],
+            seoScore: content.seo.score,
+        };
+        const html = ejs.render(template, templateData);
+        return html;
+    }
+    async write(output, outputPath) {
+        await fs.ensureDir(path.dirname(outputPath));
+        await fs.writeFile(outputPath, output, 'utf-8');
+    }
+    getFileExtension() {
+        return '.html';
+    }
+    transformPath(basePath) {
+        if (!basePath.endsWith('.html')) {
+            return basePath + '/index.html';
+        }
+        return basePath;
+    }
+    async markdownToHTML(markdown) {
+        return marked(markdown);
+    }
+    async renderSectionContent(section) {
+        switch (section.type) {
+            case 'text':
+                return await this.markdownToHTML(section.content);
+            case 'comparison':
+                return this.renderComparisonTable(section.data);
+            case 'list':
+                return this.renderList(section.data);
+            case 'code':
+                return this.renderCode(section.data);
+            default:
+                return await this.markdownToHTML(section.content);
+        }
+    }
+    renderComparisonTable(data) {
+        if (!data || !data.headers || !data.rows) {
+            return '';
+        }
+        let html = '<table class="comparison-table">\n';
+        html += '  <thead>\n    <tr>\n';
+        data.headers.forEach((header) => {
+            html += `      <th>${header}</th>\n`;
+        });
+        html += '    </tr>\n  </thead>\n';
+        html += '  <tbody>\n';
+        data.rows.forEach((row) => {
+            html += '    <tr>\n';
+            row.forEach((cell) => {
+                html += `      <td>${cell}</td>\n`;
+            });
+            html += '    </tr>\n';
+        });
+        html += '  </tbody>\n';
+        html += '</table>';
+        return html;
+    }
+    renderList(data) {
+        if (!data || !data.items) {
+            return '';
+        }
+        const tag = data.ordered ? 'ol' : 'ul';
+        let html = `<${tag} class="content-list">\n`;
+        data.items.forEach((item) => {
+            html += '  <li>\n';
+            html += `    <strong>${item.title}</strong>\n`;
+            if (item.description) {
+                html += `    <p>${item.description}</p>\n`;
+            }
+            html += '  </li>\n';
+        });
+        html += `</${tag}>`;
+        return html;
+    }
+    renderCode(data) {
+        if (!data || !data.code) {
+            return '';
+        }
+        let html = '<div class="code-block">\n';
+        if (data.caption) {
+            html += `  <div class="code-caption">${data.caption}</div>\n`;
+        }
+        html += `  <pre><code class="language-${data.language || 'plaintext'}">${this.escapeHtml(data.code)}</code></pre>\n`;
+        html += '</div>';
+        return html;
+    }
+    escapeHtml(text) {
+        const map = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#039;'
+        };
+        return text.replace(/[&<>"']/g, (m) => map[m]);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/html/index.js.map

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