@vinitngr/serper-v 1.0.0

package/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: serperV
+description: Real-time web search (news, places, organic) via Serper API.
+---
+
+# Serper Search
+
+## Usage
+```bash
+serperV search --query "Term" --type search --limit 5
+```
+- **Auth**: `serperV auth <key>` (saves to `~/.vinit/credentials.json`) or `export SERPER_API_KEY=key`.
+- **Types**: `search`, `news`, `places`, `images`, `scholar`, `videos`.
+- **Flags**: `-q` (query), `-l` (limit), `-t` (type), `-g` (country), `-h` (language).
+
+## Installation
+`npm install -g @vinitngr/serper-v`
+
+## Errors
+If 401/403: Run `serperV auth <new_key>`.

package/dist/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import axios from 'axios';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const CONFIG_DIR = path.join(os.homedir(), '.vinit');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'credentials.json');
+function getStoredApiKey() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+            return config.serperV || null;
+        }
+    }
+    catch (error) {
+    }
+    return null;
+}
+const program = new Command();
+program
+    .name('serperV')
+    .description('Optimal Serper search for AI agents (TypeScript)')
+    .version('2.1.0');
+program
+    .command('auth')
+    .description('Store Serper API key persistently')
+    .argument('<key>', 'Your Serper API key')
+    .action((key) => {
+    try {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        const config = fs.existsSync(CONFIG_FILE)
+            ? JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'))
+            : {};
+        config.serperV = key;
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+        console.log('\n✅ API Key stored successfully in ~/.vinit/credentials.json\n');
+    }
+    catch (error) {
+        console.error('\n❌ Failed to store API key:', error.message, '\n');
+        process.exit(1);
+    }
+});
+program
+    .command('search')
+    .description('Search the web using Serper API')
+    .requiredOption('-q, --query <string>', 'Search query')
+    .option('-l, --limit <number>', 'Number of results', (val) => parseInt(val), 10)
+    .option('-t, --type <string>', 'Search type (search, news, places, images, scholar, videos, shopping)', 'search')
+    .option('-g, --gl <string>', 'Country code (e.g., us, in)', 'us')
+    .option('-h, --hl <string>', 'Language code (e.g., en, hi)', 'en')
+    .option('-p, --page <number>', 'Page number', (val) => parseInt(val), 1)
+    .option('-a, --autocorrect <boolean>', 'Enable/disable autocorrect', (val) => val === 'true', true)
+    .action(async (options) => {
+    const apiKey = process.env.SERPER_API_KEY || getStoredApiKey();
+    if (!apiKey) {
+        console.error('\n❌ Error: Serper API key not found.');
+        console.error('💡 Please set it using: serperV auth <your_key>');
+        console.error('🛠️  Or via environment: export SERPER_API_KEY="your_key_here"\n');
+        process.exit(1);
+    }
+    const config = {
+        method: 'post',
+        url: `https://google.serper.dev/${options.type}`,
+        headers: {
+            'X-API-KEY': apiKey,
+            'Content-Type': 'application/json'
+        },
+        data: {
+            q: options.query,
+            num: options.limit,
+            gl: options.gl,
+            hl: options.hl,
+            page: options.page,
+            autocorrect: options.autocorrect
+        }
+    };
+    try {
+        const response = await axios(config);
+        console.log(JSON.stringify(response.data, null, 2));
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            if (axiosError.response?.status === 401 || axiosError.response?.status === 403) {
+                console.error('\n❌ Error: Unauthorized. Your Serper API key is invalid or expired.');
+                console.error('💡 Update it using: serperV auth <new_key>\n');
+            }
+            else {
+                console.error('\n❌ Search failed:', axiosError.response?.data?.message || axiosError.message);
+                if (axiosError.response?.data) {
+                    console.error('Details:', JSON.stringify(axiosError.response.data, null, 2));
+                }
+                console.error('');
+            }
+        }
+        else {
+            console.error('\n❌ An unexpected error occurred:', error.message, '\n');
+        }
+        process.exit(1);
+    }
+});
+program.parse();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@vinitngr/serper-v",
+  "version": "1.0.0",
+  "description": "Optimal Serper Search CLI for AI Agents",
+  "main": "dist/index.js",
+  "bin": {
+    "serperV": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "SKILL.md"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "test:search": "node test-serper.js"
+  },
+  "keywords": [
+    "serper",
+    "search",
+    "cli",
+    "ai",
+    "agent"
+  ],
+  "author": "vinitngr",
+  "license": "ISC",
+  "dependencies": {
+    "commander": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/commander": "^2.12.0",
+    "@types/node": "^25.2.1",
+    "axios": "^1.13.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}