{"_id":"@conde-digital-solutions/seo-pilot","name":"@conde-digital-solutions/seo-pilot","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@conde-digital-solutions/seo-pilot","version":"0.1.0","description":"Organic SEO promotion CLI tool","type":"module","license":"MIT","main":"./dist/cli.js","types":"./dist/cli.d.ts","bin":{"seo-pilot":"dist/cli.js"},"scripts":{"dev":"tsx src/cli.ts","build":"tsc","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc --noEmit","lint":"eslint src/ tests/","prepublishOnly":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/xConde/seo-pilot.git"},"keywords":["seo","cli","indexing","rank-tracking","audit","indexnow","google-search-console"],"engines":{"node":">=20"},"dependencies":{"cheerio":"^1.0.0","jsonwebtoken":"^9.0.0","zod":"^3.23.0"},"devDependencies":{"@types/jsonwebtoken":"^9.0.0","@types/node":"^20.0.0","@vitest/coverage-v8":"^3.0.0","eslint":"^9.0.0","tsx":"^4.0.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"@conde-digital-solutions/seo-pilot@0.1.0","gitHead":"22f1449f3f0cd13e007b5682ea9749f0283e42b4","bugs":{"url":"https://github.com/xConde/seo-pilot/issues"},"homepage":"https://github.com/xConde/seo-pilot#readme","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-8JPfqcVUHQ9N92bW9aooQ5+p0jGAfqFJXtKIhrxn0o/JKYi0v5FLI37IihQStLg9puwZdrjSPzS7296Vmz8fXA==","shasum":"49365be4f99b8403ea1fcc0e7d548a66647f0e3f","tarball":"https://registry.npmjs.org/@conde-digital-solutions/seo-pilot/-/seo-pilot-0.1.0.tgz","fileCount":87,"unpackedSize":174810,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCMz5t0CWCKunhsl8R4DyPWPjKnsbOu/3y1DkEqme9kjgIgWANJoZjV0rfgMIP5QhV5FOBLDjgCDQs0lmoRqWWGVZU="}]},"_npmUser":{"name":"conde","email":"ed@condedigitalsolutions.com"},"directories":{},"maintainers":[{"name":"conde","email":"ed@condedigitalsolutions.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/seo-pilot_0.1.0_1772161511429_0.8630751012949309"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-27T03:05:11.367Z","0.1.0":"2026-02-27T03:05:11.583Z","modified":"2026-02-27T03:05:11.765Z"},"maintainers":[{"name":"conde","email":"ed@condedigitalsolutions.com"}],"description":"Organic SEO promotion CLI tool","homepage":"https://github.com/xConde/seo-pilot#readme","keywords":["seo","cli","indexing","rank-tracking","audit","indexnow","google-search-console"],"repository":{"type":"git","url":"git+https://github.com/xConde/seo-pilot.git"},"bugs":{"url":"https://github.com/xConde/seo-pilot/issues"},"license":"MIT","readme":"# seo-pilot\n\nCLI tool that automates organic SEO — indexing, rank tracking, on-page audits, and discovery of forum/directory engagement opportunities.\n\n## Prerequisites\n\n- Node >= 20\n- API credentials for: IndexNow, Google Cloud (service account), Bing Webmaster, Google Custom Search\n- See [Setup Guide](docs/setup-guide.md) for credential walkthrough, or run the interactive wizard below\n\n## Quick Start\n\n```bash\nnpm install\nnpx seo-pilot setup            # interactive credential wizard\nnpx seo-pilot index --dry-run  # preview URLs without submitting\n```\n\n## Commands\n\n| Command | Description | Key Flags |\n|---------|-------------|-----------|\n| `setup` | Interactive credential setup wizard | — |\n| `index` | Submit URLs to search engines (IndexNow, Google, Bing) | `--service <name>`, `--dry-run` |\n| `inspect` | Check indexing status via Google URL Inspection API | `--url <url>` |\n| `rank` | Track keyword positions via Search Console | `--days <n>`, `--keyword <kw>` |\n| `discover` | Find forum/directory engagement opportunities | `--type <type>`, `--keyword <kw>` |\n| `audit` | Validate on-page SEO (meta, schema, links, sitemap) | `--url <url>`, `--checks <list>` |\n\nAll commands accept `--config <path>` (default: `seo-pilot.config.json`).\n\n## Config\n\n- Schema: `src/config/schema.ts` (Zod) — source of truth for all config fields\n- Example: `seo-pilot.config.example.json` — copy and fill in your values\n- Supports `${VAR}` substitution in config values (e.g., `\"${BING_WEBMASTER_API_KEY}\"`)\n- Auto-loads `.env.local` for secrets (gitignored)\n\n## State\n\n`.seo-pilot/` directory (gitignored) stores operation history as JSON arrays:\n\n| File | Purpose |\n|------|---------|\n| `index-history.json` | Indexing submission results |\n| `inspect-history.json` | URL inspection results |\n| `rank-history.json` | Keyword ranking snapshots |\n| `discover-history.json` | Discovered opportunities (used to deduplicate) |\n| `audit-history.json` | On-page audit results |\n\n## CI Integration\n\nGitHub Actions snippet for post-deploy indexing:\n\n```yaml\n- name: Notify search engines\n  run: npx seo-pilot index --service indexnow\n  env:\n    BING_WEBMASTER_API_KEY: ${{ secrets.BING_WEBMASTER_API_KEY }}\n```\n\n## Development\n\n```bash\nnpm test                        # vitest (165 tests)\nnpx tsc --noEmit                # typecheck\nnpx tsx src/cli.ts <command>    # run without building\nnpm run build                   # compile to dist/\n```\n","readmeFilename":"README.md","_rev":"1-1fd00b82cefb9b07090392a20f80341f"}