orangeslice 1.1.0 → 1.4.0

package/README.md

@@ -1,21 +1,53 @@
 # orangeslice
 
-Rate-limited B2B API client for AI agents. Call `orangeslice.b2b.sql()` anywhere, anytime - concurrency and rate limiting handled automatically.
+Turn any AI agent into a B2B sales research assistant with access to **1B+ LinkedIn profiles**.
 
-## Documentation
+```bash
+npx orangeslice
+```
+
+This copies documentation to `./orangeslice-docs/` and installs the package. Point your AI agent (Claude Code, Cursor, etc.) to `./orangeslice-docs/AGENTS.md` and it becomes your sales research agent.
+
+## What Your Agent Can Do
+
+| Function | Capability |
+|----------|------------|
+| `b2b` | Query 1B+ LinkedIn profiles, companies, funding, jobs |
+| `serp` | Google search for news, articles, reviews |
+| `firecrawl` | Scrape websites, extract social URLs |
+
+## Quick Example
+
+```typescript
+import { orangeslice } from 'orangeslice';
+
+// B2B Database - Company + people research
+const company = await orangeslice.b2b.sql(`
+  SELECT company_name, employee_count, description
+  FROM linkedin_company WHERE domain = 'stripe.com'
+`);
 
-**Before writing queries, read the docs in [`./docs/`](./docs/):**
+// Google Search - Find news and articles
+const news = await orangeslice.serp.search("Stripe funding 2024");
+
+// Website Scraping - Get page content + social links
+const about = await orangeslice.firecrawl.scrape("https://stripe.com/about");
+console.log(about.markdown);      // Page as markdown
+console.log(about.socialUrls);    // LinkedIn, Twitter, etc.
+```
+
+All calls are rate-limited automatically.
+
+## Documentation
 
 | Doc | What it covers |
 |-----|----------------|
-| [B2B_DATABASE.md](./docs/B2B_DATABASE.md) | Database overview, API endpoint, request format |
+| [**AGENTS.md**](./docs/AGENTS.md) | **Start here** - Sales agent instructions |
+| [B2B_DATABASE.md](./docs/B2B_DATABASE.md) | Database overview, query examples |
 | [B2B_SCHEMA.md](./docs/B2B_SCHEMA.md) | All tables and columns |
-| [B2B_EMPLOYEE_SEARCH.md](./docs/B2B_EMPLOYEE_SEARCH.md) | How to search for people/employees |
+| [B2B_EMPLOYEE_SEARCH.md](./docs/B2B_EMPLOYEE_SEARCH.md) | Finding people by title/company |
 | [B2B_GENERALIZATION_RULES.md](./docs/B2B_GENERALIZATION_RULES.md) | Query patterns and best practices |
 | [B2B_NLP_QUERY_MAPPINGS.md](./docs/B2B_NLP_QUERY_MAPPINGS.md) | Natural language to SQL mappings |
-| [B2B_TABLE_INDICES.ts](./docs/B2B_TABLE_INDICES.ts) | TypeScript types for all tables |
-
-Start with `B2B_DATABASE.md` and `B2B_SCHEMA.md` to understand the data model.
 
 ## Installation
 

package/dist/b2b.js

@@ -7,7 +7,7 @@ exports.query = query;
 const queue_1 = require("./queue");
 // Default config
 let config = {
-    proxyUrl: process.env.B2B_SQL_PROXY_URL || "http://165.22.151.131:3000/query",
+    proxyUrl: process.env.ORANGESLICE_API_URL || "https://orangeslice.ai/api/function?functionId=b2b",
     concurrency: 2,
     minDelayMs: 100, // 100ms between requests = max 10/sec
 };

package/dist/cli.js

@@ -36,26 +36,45 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 const DOCS_DIR = path.join(__dirname, "..", "docs");
 const TARGET_DIR = path.join(process.cwd(), "orangeslice-docs");
 async function main() {
-    console.log("🍊 orangeslice - injecting B2B docs into your project...\n");
-    // Create target directory
+    console.log("\n orangeslice - setting up B2B client for AI agents...\n");
+    // 1. Copy docs
+    console.log("1. Copying B2B documentation...");
     if (!fs.existsSync(TARGET_DIR)) {
         fs.mkdirSync(TARGET_DIR, { recursive: true });
     }
-    // Copy all docs
     const files = fs.readdirSync(DOCS_DIR);
-    let copied = 0;
     for (const file of files) {
         const src = path.join(DOCS_DIR, file);
         const dest = path.join(TARGET_DIR, file);
         fs.copyFileSync(src, dest);
-        console.log(`  ✓ ${file}`);
-        copied++;
+        console.log(`   ${file}`);
     }
-    console.log(`\n✅ Copied ${copied} docs to ./orangeslice-docs/`);
-    console.log("\nYour AI agent can now read these docs to understand the B2B database.");
-    console.log("Start with B2B_DATABASE.md and B2B_SCHEMA.md\n");
+    console.log(`   Copied ${files.length} docs to ./orangeslice-docs/\n`);
+    // 2. Install package
+    console.log("2. Installing orangeslice package...");
+    try {
+        (0, child_process_1.execSync)("npm install orangeslice", { stdio: "inherit", cwd: process.cwd() });
+    }
+    catch {
+        console.log("   (skipped - no package.json or npm not available)\n");
+    }
+    // 3. Show usage
+    console.log("\n Done! Your AI agent is ready.\n");
+    console.log("   Point your AI agent (Claude, Cursor, etc.) to:\n");
+    console.log("   ./orangeslice-docs/AGENTS.md\n");
+    console.log("   This tells the agent how to act as your sales research assistant");
+    console.log("   with access to 1B+ LinkedIn profiles.\n");
+    console.log("   Example usage:\n");
+    console.log('   import { orangeslice } from "orangeslice";');
+    console.log("");
+    console.log("   const company = await orangeslice.b2b.sql(`");
+    console.log("     SELECT company_name, employee_count, description");
+    console.log("     FROM linkedin_company");
+    console.log("     WHERE domain = 'stripe.com'");
+    console.log("   `);\n");
 }
 main().catch(console.error);

package/dist/firecrawl.d.ts

@@ -0,0 +1,49 @@
+export interface SocialUrls {
+    emailGeneral: string[];
+    facebookProfile: string[];
+    instagramProfile: string[];
+    twitterUser: string[];
+    youtubeChannel: string[];
+    youtubeVideo: string[];
+    tiktokProfile: string[];
+    linkedinProfile: string[];
+    linkedinCompany: string[];
+}
+export interface PageData {
+    markdown: string;
+    links: string[];
+}
+export interface FirecrawlResponse {
+    markdown: string;
+    data: PageData[];
+    socialUrls: SocialUrls;
+    error?: string;
+}
+/**
+ * Scrape a website and get markdown content.
+ * Automatically rate-limited.
+ *
+ * @param url - URL to scrape
+ * @param limit - Number of pages to crawl (default 1 for single page scrape)
+ *
+ * @example
+ * // Single page scrape
+ * const page = await firecrawl.scrape("https://stripe.com/about");
+ *
+ * // Multi-page crawl
+ * const site = await firecrawl.scrape("https://stripe.com", 5);
+ */
+export declare function scrape(url: string, limit?: number): Promise<FirecrawlResponse>;
+/**
+ * Scrape a website and return just the markdown content
+ */
+export declare function markdown(url: string): Promise<string>;
+/**
+ * Scrape a website and extract social URLs
+ */
+export declare function socials(url: string): Promise<SocialUrls>;
+export declare const firecrawl: {
+    scrape: typeof scrape;
+    markdown: typeof markdown;
+    socials: typeof socials;
+};

package/dist/firecrawl.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firecrawl = void 0;
+exports.scrape = scrape;
+exports.markdown = markdown;
+exports.socials = socials;
+const queue_1 = require("./queue");
+const API_URL = process.env.ORANGESLICE_API_URL || "https://orangeslice.ai/api/function?functionId=firecrawl";
+// Shared queue for all Firecrawl requests
+const queue = (0, queue_1.createQueue)(2);
+const rateLimiter = (0, queue_1.createRateLimiter)(500); // 500ms between requests (crawls are expensive)
+/**
+ * Scrape a website and get markdown content.
+ * Automatically rate-limited.
+ *
+ * @param url - URL to scrape
+ * @param limit - Number of pages to crawl (default 1 for single page scrape)
+ *
+ * @example
+ * // Single page scrape
+ * const page = await firecrawl.scrape("https://stripe.com/about");
+ *
+ * // Multi-page crawl
+ * const site = await firecrawl.scrape("https://stripe.com", 5);
+ */
+async function scrape(url, limit = 1) {
+    return queue(async () => {
+        return rateLimiter(async () => {
+            const response = await fetch(API_URL, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ url, limit }),
+            });
+            if (!response.ok) {
+                throw new Error(`Firecrawl request failed: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (data.error) {
+                throw new Error(`Firecrawl error: ${data.error}`);
+            }
+            return data;
+        });
+    });
+}
+/**
+ * Scrape a website and return just the markdown content
+ */
+async function markdown(url) {
+    const data = await scrape(url, 1);
+    return data.markdown;
+}
+/**
+ * Scrape a website and extract social URLs
+ */
+async function socials(url) {
+    const data = await scrape(url, 1);
+    return data.socialUrls;
+}
+// Export as namespace
+exports.firecrawl = {
+    scrape,
+    markdown,
+    socials,
+};

package/dist/index.d.ts

@@ -1,23 +1,23 @@
 import { b2b } from "./b2b";
-export { b2b };
+import { serp } from "./serp";
+import { firecrawl } from "./firecrawl";
+export { b2b, serp, firecrawl };
 /**
- * Main orangeslice namespace
+ * Main orangeslice namespace - AI sales agent toolkit
  *
  * @example
  * import { orangeslice } from 'orangeslice';
  *
- * // Configure (optional)
- * orangeslice.b2b.configure({ concurrency: 3 });
- *
- * // Query - automatically rate-limited
+ * // B2B Database - 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // Multiple parallel calls are queued automatically
- * const results = await Promise.all([
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'stripe'"),
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'openai'"),
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'meta'"),
- * ]);
+ * // Google Search
+ * const results = await orangeslice.serp.search("best CRM software 2024");
+ *
+ * // Website Scraping
+ * const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
+ *
+ * // All calls are automatically rate-limited and queued
  */
 export declare const orangeslice: {
     b2b: {
@@ -25,5 +25,14 @@ export declare const orangeslice: {
         query: typeof import("./b2b").query;
         configure: typeof import("./b2b").configure;
     };
+    serp: {
+        search: typeof import("./serp").search;
+        organic: typeof import("./serp").organic;
+    };
+    firecrawl: {
+        scrape: typeof import("./firecrawl").scrape;
+        markdown: typeof import("./firecrawl").markdown;
+        socials: typeof import("./firecrawl").socials;
+    };
 };
 export default orangeslice;

package/dist/index.js

@@ -1,28 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.orangeslice = exports.b2b = void 0;
+exports.orangeslice = exports.firecrawl = exports.serp = exports.b2b = void 0;
 const b2b_1 = require("./b2b");
 Object.defineProperty(exports, "b2b", { enumerable: true, get: function () { return b2b_1.b2b; } });
+const serp_1 = require("./serp");
+Object.defineProperty(exports, "serp", { enumerable: true, get: function () { return serp_1.serp; } });
+const firecrawl_1 = require("./firecrawl");
+Object.defineProperty(exports, "firecrawl", { enumerable: true, get: function () { return firecrawl_1.firecrawl; } });
 /**
- * Main orangeslice namespace
+ * Main orangeslice namespace - AI sales agent toolkit
  *
  * @example
  * import { orangeslice } from 'orangeslice';
  *
- * // Configure (optional)
- * orangeslice.b2b.configure({ concurrency: 3 });
- *
- * // Query - automatically rate-limited
+ * // B2B Database - 1B+ LinkedIn profiles
  * const companies = await orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE domain = 'stripe.com'");
  *
- * // Multiple parallel calls are queued automatically
- * const results = await Promise.all([
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'stripe'"),
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'openai'"),
- *   orangeslice.b2b.sql("SELECT * FROM linkedin_company WHERE universal_name = 'meta'"),
- * ]);
+ * // Google Search
+ * const results = await orangeslice.serp.search("best CRM software 2024");
+ *
+ * // Website Scraping
+ * const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
+ *
+ * // All calls are automatically rate-limited and queued
  */
 exports.orangeslice = {
     b2b: b2b_1.b2b,
+    serp: serp_1.serp,
+    firecrawl: firecrawl_1.firecrawl,
 };
 exports.default = exports.orangeslice;

package/dist/serp.d.ts

@@ -0,0 +1,41 @@
+export interface SerpResult {
+    title: string;
+    link: string;
+    snippet: string;
+    position?: number;
+}
+export interface SerpResponse {
+    organic_results?: SerpResult[];
+    related_questions?: Array<{
+        question: string;
+        snippet: string;
+    }>;
+    error?: string;
+}
+export interface SerpOptions {
+    /** Regex pattern to filter links */
+    linkRegexPattern?: string;
+    /** Enable advanced search features */
+    advance_search?: boolean;
+    /** Page number (default 1) */
+    page?: number;
+    /** Time-based search filter (e.g., "qdr:d" for past day, "qdr:w" for past week) */
+    tbs?: string;
+}
+/**
+ * Search Google via SERP API.
+ * Automatically rate-limited.
+ *
+ * @example
+ * const results = await serp.search("best CRM software 2024");
+ * const filtered = await serp.search("site:linkedin.com CEO stripe", { linkRegexPattern: "linkedin.com/in/" });
+ */
+export declare function search(query: string, options?: SerpOptions): Promise<SerpResponse>;
+/**
+ * Search and return just the organic results
+ */
+export declare function organic(query: string, options?: SerpOptions): Promise<SerpResult[]>;
+export declare const serp: {
+    search: typeof search;
+    organic: typeof organic;
+};

package/dist/serp.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serp = void 0;
+exports.search = search;
+exports.organic = organic;
+const queue_1 = require("./queue");
+const API_URL = process.env.ORANGESLICE_API_URL || "https://orangeslice.ai/api/function?functionId=serp";
+// Shared queue for all SERP requests
+const queue = (0, queue_1.createQueue)(2);
+const rateLimiter = (0, queue_1.createRateLimiter)(200); // 200ms between requests
+/**
+ * Search Google via SERP API.
+ * Automatically rate-limited.
+ *
+ * @example
+ * const results = await serp.search("best CRM software 2024");
+ * const filtered = await serp.search("site:linkedin.com CEO stripe", { linkRegexPattern: "linkedin.com/in/" });
+ */
+async function search(query, options = {}) {
+    return queue(async () => {
+        return rateLimiter(async () => {
+            const response = await fetch(API_URL, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    query,
+                    ...options,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`SERP request failed: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            if (data.error) {
+                throw new Error(`SERP error: ${data.error}`);
+            }
+            return data;
+        });
+    });
+}
+/**
+ * Search and return just the organic results
+ */
+async function organic(query, options = {}) {
+    const data = await search(query, options);
+    return data.organic_results || [];
+}
+// Export as namespace
+exports.serp = {
+    search,
+    organic,
+};

package/docs/AGENTS.md

@@ -0,0 +1,319 @@
+# Sales Agent
+
+You are a B2B sales research agent with access to:
+- **1.15 billion LinkedIn profiles** and millions of companies
+- **Google Search** (SERP API)
+- **Website scraping** (Firecrawl)
+
+## What You Can Do
+
+| Capability | Tool | Example |
+|------------|------|---------|
+| **Company research** | `b2b` | Look up any company by domain, name, or LinkedIn URL |
+| **Find decision makers** | `b2b` | Find C-suite, VPs, Directors at target companies |
+| **Employee lookup** | `b2b` | Search employees by title, role, or department |
+| **Funding intelligence** | `b2b` | Find recently funded companies and their investors |
+| **Google search** | `serp` | Search for company news, press releases, reviews |
+| **Website scraping** | `firecrawl` | Extract content from company websites |
+
+
+## Quick Start
+
+```typescript
+import { orangeslice } from 'orangeslice';
+
+// 1. B2B Database - Company & people research
+const company = await orangeslice.b2b.sql(`
+  SELECT company_name, domain, employee_count, description
+  FROM linkedin_company WHERE domain = 'stripe.com'
+`);
+
+// 2. Google Search - Find news, articles, reviews
+const news = await orangeslice.serp.search("Stripe funding 2024");
+
+// 3. Website Scraping - Get company page content
+const about = await orangeslice.firecrawl.scrape("https://stripe.com/about");
+```
+
+All calls are automatically rate-limited. Fire away freely.
+
+## Sales Workflows
+
+### 1. Research a Target Account
+
+```sql
+-- Step 1: Get company details
+SELECT id, company_name, domain, employee_count, locality, description
+FROM linkedin_company
+WHERE domain = 'openai.com';
+
+-- Step 2: Find their leadership team
+SELECT lp.first_name, lp.last_name, lp.headline, pos.title, lp.public_profile_url
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+WHERE pos.linkedin_company_id = 11130470  -- OpenAI's ID from step 1
+  AND pos.end_date IS NULL
+  AND (pos.title ILIKE 'ceo%' OR pos.title ILIKE 'cto%' OR pos.title ILIKE 'cfo%'
+       OR pos.title ILIKE '%vp%' OR pos.title ILIKE '%head of%')
+LIMIT 30;
+```
+
+### 2. Find Your Ideal Customer Profile (ICP)
+
+```sql
+-- Software companies, 100-500 employees, with recent funding
+SELECT lc.company_name, lc.domain, lc.employee_count,
+       cf.round_name, cf.round_date, cf.round_amount
+FROM linkedin_company lc
+JOIN linkedin_crunchbase_funding cf ON cf.linkedin_company_id = lc.id
+WHERE lc.industry_code = 4  -- Software Development
+  AND lc.employee_count BETWEEN 100 AND 500
+  AND cf.round_date >= '2024-01-01'
+ORDER BY cf.round_date DESC
+LIMIT 50;
+```
+
+### 3. Find Specific Personas
+
+```sql
+-- Heads of Sales at mid-market companies
+SELECT lp.first_name, lp.last_name, lp.headline,
+       pos.title, lc.company_name, lc.employee_count
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+WHERE pos.end_date IS NULL
+  AND lc.employee_count BETWEEN 100 AND 1000
+  AND (pos.title ILIKE '%head of sales%'
+       OR pos.title ILIKE '%vp sales%'
+       OR pos.title ILIKE '%chief revenue%')
+LIMIT 30;
+```
+
+### 4. Competitive Intelligence
+
+```sql
+-- Who works at competitor company?
+SELECT lp.first_name, lp.last_name, lp.headline, pos.title
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+WHERE pos.linkedin_company_id = 2135371  -- Competitor's ID
+  AND pos.end_date IS NULL
+  AND pos.title ILIKE '%sales%'
+LIMIT 50;
+```
+
+---
+
+## Google Search (SERP)
+
+Search the web for company news, press releases, reviews, and more.
+
+```typescript
+// Basic search
+const results = await orangeslice.serp.search("Stripe Series C funding");
+
+// Get just organic results
+const organic = await orangeslice.serp.organic("best CRM software 2024");
+
+// Filter by site
+const linkedin = await orangeslice.serp.search("site:linkedin.com/in CEO Ramp");
+
+// Time-based search (past week)
+const recent = await orangeslice.serp.search("OpenAI news", { tbs: "qdr:w" });
+```
+
+### SERP Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `linkRegexPattern` | string | Filter results by URL pattern |
+| `advance_search` | boolean | Enable advanced search features |
+| `page` | number | Page number (default 1) |
+| `tbs` | string | Time filter: `qdr:d` (day), `qdr:w` (week), `qdr:m` (month) |
+
+### Use Cases
+
+- Find company news and press releases
+- Research competitors' public announcements
+- Find LinkedIn profiles via Google
+- Check company reviews on G2, Capterra, etc.
+
+---
+
+## Website Scraping (Firecrawl)
+
+Scrape any website and get markdown content + extracted social URLs.
+
+```typescript
+// Scrape a single page
+const page = await orangeslice.firecrawl.scrape("https://stripe.com/about");
+console.log(page.markdown);       // Page content as markdown
+console.log(page.socialUrls);     // Extracted social links
+
+// Just get markdown
+const content = await orangeslice.firecrawl.markdown("https://company.com/team");
+
+// Just get social URLs
+const socials = await orangeslice.firecrawl.socials("https://company.com");
+// Returns: { linkedinCompany: [...], twitterUser: [...], ... }
+
+// Multi-page crawl (up to 5 pages)
+const site = await orangeslice.firecrawl.scrape("https://company.com", 5);
+```
+
+### Social URLs Extracted
+
+| Field | Description |
+|-------|-------------|
+| `linkedinCompany` | Company LinkedIn pages |
+| `linkedinProfile` | Individual LinkedIn profiles |
+| `twitterUser` | Twitter/X profiles |
+| `facebookProfile` | Facebook pages |
+| `instagramProfile` | Instagram profiles |
+| `youtubeChannel` | YouTube channels |
+| `tiktokProfile` | TikTok profiles |
+| `emailGeneral` | Email addresses |
+
+### Use Cases
+
+- Scrape company "About" or "Team" pages
+- Find social media links from company websites
+- Extract contact emails from websites
+- Get company descriptions from their own sites
+
+---
+
+## Key Tables
+
+| Table | Records | Use For |
+|-------|---------|---------|
+| `linkedin_company` | Millions | Company lookup, enrichment |
+| `linkedin_profile` | 1.15B | Profile details |
+| `linkedin_profile_position3` | 2.6B | Job history, current employer |
+| `linkedin_crunchbase_funding` | - | Funding rounds |
+| `linkedin_job` | 1.48B | Job postings |
+
+## Performance Rules
+
+### ✅ Fast Queries (use these)
+```sql
+-- By domain (indexed)
+WHERE domain = 'stripe.com'
+
+-- By universal_name (indexed)
+WHERE universal_name = 'stripe'
+
+-- By company ID (indexed)
+WHERE linkedin_company_id = 2135371
+
+-- By profile ID (indexed)
+WHERE linkedin_profile_id = 12345
+```
+
+### ⚠️ Slow Queries (avoid these)
+```sql
+-- Text search on names (no index)
+WHERE company_name ILIKE '%stripe%'  -- SLOW
+
+-- Headline search (full scan)
+WHERE headline ILIKE '%sales%'  -- SLOW
+
+-- COUNT on huge companies
+SELECT COUNT(*) FROM ... WHERE linkedin_company_id = 1586  -- TIMEOUT
+```
+
+### Company Size Matters
+
+| Company Size | Simple Query | Aggregations |
+|-------------|--------------|--------------|
+| Small (<1K) | 4-20ms | 5-50ms |
+| Medium (1K-10K) | 10-30ms | 100-500ms |
+| Large (10K-100K) | 10-40ms | 1-15s |
+| Massive (100K+) | 15-65ms | **TIMEOUT** |
+
+**For Amazon/Google (100K+ employees):** Only use simple `LIMIT` queries, no `COUNT` or `GROUP BY`.
+
+## Common Company IDs
+
+| Company | ID | Employees |
+|---------|-----|-----------|
+| Amazon | 1586 | 770K |
+| Google | 1441 | 330K |
+| Stripe | 2135371 | ~9K |
+| OpenAI | 11130470 | ~7K |
+| Ramp | 1406226 | ~3.5K |
+
+## Title Search Patterns
+
+| Role | ILIKE Pattern |
+|------|---------------|
+| C-Suite | `ceo%`, `cto%`, `cfo%`, `%chief%` |
+| VPs | `%vp %`, `%vice president%` |
+| Directors | `%director%`, `%head of%` |
+| Sales | `%account exec%`, `%sales rep%`, `%ae %` |
+| SDRs | `%sales development%`, `%sdr%`, `%bdr%` |
+| Engineering | `%engineer%`, `%developer%` |
+| Recruiters | `%recruit%`, `%talent%`, `%sourcer%` |
+
+## What You Cannot Do
+
+❌ **No direct contact data** - email addresses and phone numbers are restricted  
+❌ **No Indeed data** - Indeed tables are restricted  
+❌ **No traffic/web data** - Domain traffic and web analytics restricted
+
+## Rate Limits
+
+The `orangeslice` package automatically handles rate limiting:
+
+| Function | Concurrency | Min Delay |
+|----------|-------------|-----------|
+| `b2b` | 2 concurrent | 100ms |
+| `serp` | 2 concurrent | 200ms |
+| `firecrawl` | 2 concurrent | 500ms |
+
+You can fire off many calls - they'll be queued automatically.
+
+## Detailed Documentation
+
+For comprehensive schema and query patterns, see:
+- `B2B_DATABASE.md` - Full database guide with examples
+- `B2B_SCHEMA.md` - Complete table schemas
+- `B2B_EMPLOYEE_SEARCH.md` - Finding employees by title
+
+## Example Session
+
+**User:** "Research Ramp - give me everything"
+
+**Agent:**
+```typescript
+import { orangeslice } from 'orangeslice';
+
+// 1. B2B Database - Company info + leadership
+const company = await orangeslice.b2b.sql(`
+  SELECT id, company_name, domain, employee_count, locality, description
+  FROM linkedin_company WHERE domain = 'ramp.com'
+`);
+
+const leadership = await orangeslice.b2b.sql(`
+  SELECT lp.first_name, lp.last_name, lp.headline, pos.title
+  FROM linkedin_profile lp
+  JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+  WHERE pos.linkedin_company_id = 1406226
+    AND pos.end_date IS NULL
+    AND (pos.title ILIKE 'ceo%' OR pos.title ILIKE 'cto%' OR pos.title ILIKE '%vp%')
+  LIMIT 20
+`);
+
+// 2. Google Search - Recent news
+const news = await orangeslice.serp.search("Ramp fintech funding 2024", { tbs: "qdr:m" });
+
+// 3. Website Scraping - About page + socials
+const about = await orangeslice.firecrawl.scrape("https://ramp.com/about");
+console.log(about.markdown);      // Company description
+console.log(about.socialUrls);    // LinkedIn, Twitter, etc.
+```
+
+---
+
+**Start by understanding what the user wants to research, then use the appropriate tools to find the information.**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orangeslice",
-  "version": "1.1.0",
-  "description": "Rate-limited B2B API client for AI agents",
+  "version": "1.4.0",
+  "description": "Turn any AI agent into a B2B sales research assistant with 1B+ LinkedIn profiles",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -21,7 +21,11 @@
     "b2b",
     "rate-limit",
     "ai-agent",
-    "linkedin"
+    "linkedin",
+    "sales-agent",
+    "claude-code",
+    "cursor",
+    "mcp"
   ],
   "author": "",
   "license": "MIT",