feat: dynamic version from package.json, new banner, doc URLs per command

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: FrancescoSaverioZuppichini

README.md

@@ -52,7 +52,7 @@ SGAI_CLI_DEBUG=1 scrapegraphai smart-scraper https://example.com -p "Extract dat
 
 ## Commands
 
-### `smart-scraper` — Extract structured data from a URL
+### `smart-scraper` — Extract structured data from a URL  [docs](https://docs.scrapegraphai.com/services/smartscraper)
 
 ```bash
 scrapegraphai smart-scraper <url> -p "Extract all product names and prices"
@@ -78,7 +78,7 @@ scrapegraphai smart-scraper https://example.com -p "Extract data" \
 | `--headers` | Custom headers as JSON object string |
 | `--plain-text` | Return plain text instead of JSON |
 
-### `search-scraper` — Search the web and extract data
+### `search-scraper` — Search the web and extract data  [docs](https://docs.scrapegraphai.com/services/searchscraper)
 
 ```bash
 scrapegraphai search-scraper "What are the top Python web frameworks?"
@@ -95,7 +95,7 @@ scrapegraphai search-scraper "Python frameworks" --no-extraction --num-results 5
 | `--stealth` | Bypass bot detection (+4 credits) |
 | `--headers` | Custom headers as JSON object string |
 
-### `markdownify` — Convert a webpage to markdown
+### `markdownify` — Convert a webpage to markdown  [docs](https://docs.scrapegraphai.com/services/markdownify)
 
 ```bash
 scrapegraphai markdownify https://example.com/article
@@ -108,7 +108,7 @@ scrapegraphai markdownify https://example.com --render-js --stealth
 | `--stealth` | Bypass bot detection (+4 credits) |
 | `--headers` | Custom headers as JSON object string |
 
-### `crawl` — Crawl and extract from multiple pages
+### `crawl` — Crawl and extract from multiple pages  [docs](https://docs.scrapegraphai.com/services/smartcrawler)
 
 ```bash
 scrapegraphai crawl https://example.com -p "Extract article titles" --max-pages 5 --depth 2
@@ -133,13 +133,13 @@ scrapegraphai crawl https://example.com -p "Extract data" \
 | `--render-js` | Enable JS rendering (+1 credit/page) |
 | `--stealth` | Bypass bot detection (+4 credits) |
 
-### `sitemap` — Get all URLs from a website's sitemap
+### `sitemap` — Get all URLs from a website's sitemap  [docs](https://docs.scrapegraphai.com/services/sitemap)
 
 ```bash
 scrapegraphai sitemap https://example.com
 ```
 
-### `scrape` — Get raw HTML content
+### `scrape` — Get raw HTML content  [docs](https://docs.scrapegraphai.com/services/scrape)
 
 ```bash
 scrapegraphai scrape https://example.com
@@ -153,7 +153,7 @@ scrapegraphai scrape https://example.com --stealth --branding --country-code US
 | `--branding` | Extract branding info (+2 credits) |
 | `--country-code` | ISO country code for geo-targeting |
 
-### `agentic-scraper` — Browser automation with AI
+### `agentic-scraper` — Browser automation with AI  [docs](https://docs.scrapegraphai.com/services/agenticscraper)
 
 ```bash
 scrapegraphai agentic-scraper https://example.com/login \
@@ -217,7 +217,7 @@ scrapegraph-cli/
 │   │   ├── credits.ts
 │   │   └── validate.ts
 │   └── utils/
-│       └── banner.ts               # ASCII banner display
+│       └── banner.ts               # ASCII banner + version from package.json
 ├── dist/                            # Build output (git-ignored)
 │   └── cli.mjs                     # Bundled ESM with shebang
 ├── package.json

src/cli.ts

@@ -1,13 +1,13 @@
 import "dotenv/config";
 import { defineCommand, runMain } from "citty";
-import { showBanner } from "./utils/banner.js";
+import { getVersion, showBanner } from "./utils/banner.js";
 
 showBanner();
 
 const main = defineCommand({
 	meta: {
 		name: "scrapegraphai",
-		version: "0.1.0",
+		version: getVersion(),
 		description: "ScrapeGraph AI CLI tool",
 	},
 	subCommands: {

src/commands/agentic-scraper.ts

@@ -39,6 +39,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/agenticscraper");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.AgenticScraperParams = {

src/commands/crawl.ts

@@ -54,6 +54,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/smartcrawler");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.CrawlParams = {

src/commands/markdownify.ts

@@ -29,6 +29,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/markdownify");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.MarkdownifyParams = {

src/commands/scrape.ts

@@ -33,6 +33,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/scrape");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.ScrapeParams = {

src/commands/search-scraper.ts

@@ -37,6 +37,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/searchscraper");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.SearchScraperParams = {

src/commands/sitemap.ts

@@ -17,6 +17,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/sitemap");
 		const key = await resolveApiKey();
 		const s = p.spinner();
 		s.start("Fetching sitemap");

src/commands/smart-scraper.ts

@@ -55,6 +55,7 @@ export default defineCommand({
 		},
 	},
 	run: async ({ args }) => {
+		log.docs("https://docs.scrapegraphai.com/services/smartscraper");
 		const key = await resolveApiKey();
 
 		const params: scrapegraphai.SmartScraperParams = {

src/lib/log.ts

@@ -18,6 +18,10 @@ export function result(data: unknown) {
 	console.log(`\n${highlight(JSON.stringify(data, null, 2))}\n`);
 }
 
+export function docs(url: string) {
+	console.log(chalk.dim(`Docs: ${url}`));
+}
+
 export function error(message?: string) {
 	p.log.error(message ?? "Unknown error");
 	process.exit(1);