seomd-cli 1.0.2 → 1.1.1

package/bin/seomd.js

@@ -32,6 +32,7 @@ program
     .description('Run citation analysis and write back _analysis blocks')
     .option('--page <url>', 'analyze a specific page only')
     .option('--intent <category>', 'analyze a specific intent category only')
+    .option('--engines <list>', 'comma-separated list of engines to scan (e.g. chatgpt,claude)')
     .action(analyzeCommand);
 
 program

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "seomd-cli",
-    "version": "1.0.2",
+    "version": "1.1.1",
     "description": "The official CLI for the SEO.md open standard — AEO infrastructure for technical founders",
     "homepage": "https://seomd.dev",
     "repository": {
@@ -47,4 +47,4 @@
         "citation-tracking",
         "llm-seo"
     ]
-}
+}

package/src/commands/analyze.js

@@ -9,6 +9,23 @@ import { writeAnalysisToSeoMd, writeReverseMd, writePageAnalysis } from '../util
 
 dotenv.config();
 
+function matchRoute(pattern, url) {
+    const cleanPattern = pattern.replace(/\/$/, '');
+    const cleanUrl = url.replace(/\/$/, '');
+    
+    if (cleanPattern.toLowerCase() === cleanUrl.toLowerCase()) {
+        return true;
+    }
+    
+    // Replace "/[param]" with optional group "(?:/([^/]+))?"
+    const regexPattern = cleanPattern
+        .replace(/\/\[[^\]]+\]/g, '(?:\\/([^/]+))?')
+        .replace(/\//g, '\\/');
+        
+    const regex = new RegExp('^' + regexPattern + '\\/?$', 'i');
+    return regex.test(url);
+}
+
 export async function analyzeCommand(options) {
     const apiKey = process.env.SEOMD_API_KEY;
     const paymentToken = process.env.SEOMD_PAYMENT_TOKEN;
@@ -66,20 +83,35 @@ export async function analyzeCommand(options) {
         }
     }
 
-    // Default to homepage if no pages defined
+    // Filter by options.page if specified
+    if (options.page) {
+        pagesList = pagesList.filter(p => matchRoute(p.url, options.page));
+    }
+
+    // Default fallback if no page matches or list is empty
     if (pagesList.length === 0) {
+        let fallbackId = 'homepage';
+        if (options.page && options.page !== '/') {
+            fallbackId = options.page
+                .replace(/^\//, '')
+                .replace(/\/$/, '')
+                .replace(/[^a-zA-Z0-9-]/g, '-');
+        }
         pagesList.push({
-            id: 'homepage',
-            url: '/',
-            primary_keyword: `best ${niche}`,
+            id: fallbackId,
+            url: options.page || '/',
+            primary_keyword: data.keywords?.primary || `best ${niche}`,
             status: 'planned'
         });
     }
 
     // Extract engines
-    const engines = data.aeo?._analysis?.engines_tracked || ['Claude', 'ChatGPT'];
+    let engines = data.aeo?._analysis?.engines_tracked || ['ChatGPT'];
+    if (options.engines) {
+        engines = options.engines.split(',').map(e => e.trim());
+    }
 
-    console.log(chalk.bold.cyan(`\n📊 foxcite: Running AI Search Audit for ${chalk.white(domain)}`));
+    console.log(chalk.bold.cyan(`\n📊 Foxcite: Running AI Search Audit for ${chalk.white(domain)}`));
     console.log(chalk.dim(`Engines: ${engines.join(', ')}`));
     console.log(chalk.dim(`Pages to scan: ${pagesList.length}`));
     console.log('');
@@ -87,15 +119,17 @@ export async function analyzeCommand(options) {
     const spinner = ora('Initializing scan sessions...').start();
 
     try {
+        const brand = data.identity?.brand || 'My Brand';
         const payload = {
             domain,
             niche,
+            brand,
             queries,
             engines,
             pages: pagesList.map(p => ({
                 id: p.id,
-                url: p.url,
-                primary_keyword: p.primary_keyword,
+                url: options.page || p.url, // Use the specific page requested if provided
+                primary_keyword: p.primary_keyword || data.keywords?.primary || `best ${niche}`,
                 status: p.status
             }))
         };
@@ -111,7 +145,8 @@ export async function analyzeCommand(options) {
         await writeAnalysisToSeoMd(doc, results, cwd);
 
         // Writeback to SEO.REVERSE.md
-        await writeReverseMd(cwd, results);
+        const brandName = data.identity?.brand || 'My Brand';
+        await writeReverseMd(cwd, results, domain, brandName);
 
         // Writeback to .seomd/pages/*.md
         await writePageAnalysis(cwd, results);

package/src/commands/sync.js

@@ -88,7 +88,8 @@ export async function syncCommand(options) {
         await writeAnalysisToSeoMd(doc, results, cwd);
 
         // Writeback to SEO.REVERSE.md
-        await writeReverseMd(cwd, results);
+        const brandName = data.identity?.brand || 'My Brand';
+        await writeReverseMd(cwd, results, domain, brandName);
 
         // Writeback to .seomd/pages/*.md
         await writePageAnalysis(cwd, results);

package/src/utils/api-client.js

@@ -9,6 +9,16 @@ const API_KEY = process.env.SEOMD_API_KEY;
 const PAYMENT_TOKEN = process.env.SEOMD_PAYMENT_TOKEN;
 const SEOMD_DOMAIN = process.env.SEOMD_DOMAIN;
 
+const getDashboardUrlFromApi = (apiUrl) => {
+    if (apiUrl.includes('127.0.0.1') || apiUrl.includes('localhost')) {
+        return 'http://localhost:3000';
+    }
+    if (apiUrl.includes('api.foxcite.com')) {
+        return 'https://app.foxcite.com';
+    }
+    return 'https://seomd.dev';
+};
+
 export const client = axios.create({
     baseURL: API_URL,
     timeout: 300000, // 5 minutes timeout for LLM audits
@@ -32,7 +42,14 @@ client.interceptors.response.use(
                 return Promise.reject(new Error('Authentication failed: Invalid or missing API key (SEOMD_API_KEY).'));
             }
             if (status === 402) {
-                return Promise.reject(new Error(`Payment Required: Insufficient scan credits. ${detail}`));
+                const dashUrl = getDashboardUrlFromApi(API_URL);
+                return Promise.reject(new Error(
+                    `Insufficient scan credits.\n\n` +
+                    `👉 For Humans: Recharge credits or upgrade your plan in the dashboard:\n` +
+                    `   ${dashUrl}/billing\n\n` +
+                    `🤖 For Programmatic Agents:\n` +
+                    `   Set SEOMD_PAYMENT_TOKEN in your environment or headers to pay-per-scan inline using USDC via the agent-native x402 protocol.`
+                ));
             }
             return Promise.reject(new Error(`API Error (${status}): ${detail}`));
         }

package/src/utils/writeback.js

@@ -67,7 +67,7 @@ export async function writeAnalysisToSeoMd(doc, response, cwd) {
  * @param {string} cwd - Current working directory
  * @param {any} response - The API response from analyze/sync
  */
-export async function writeReverseMd(cwd, response) {
+export async function writeReverseMd(cwd, response, defaultDomain = 'example.com', defaultBrand = 'My Brand') {
     const reversePath = path.join(cwd, 'SEO.REVERSE.md');
 
     const reversePages = response.page_analysis.map(p => ({
@@ -88,8 +88,8 @@ export async function writeReverseMd(cwd, response) {
     const primaryCompetitor = response.intent_analysis?.comparison?.top_cited_competitor || 'None';
 
     const reverseDoc = {
-        domain: response.domain || 'example.com',
-        brand: response.brand_name || 'My Brand',
+        domain: response.domain || defaultDomain,
+        brand: response.brand_name || defaultBrand,
         primary_competitor: primaryCompetitor,
         last_analyzed: response.aeo_analysis.last_analyzed,
         next_analysis: response.aeo_analysis.next_analysis,