orangeslice 1.6.1 → 1.7.1

package/docs/strategies.md

@@ -0,0 +1,250 @@
+# Research Strategies
+
+Patterns for prospecting, enrichment, and social listening.
+
+---
+
+## Prospecting: Two Approaches
+
+### 1. Direct Query with Filters (Preferred)
+
+Use when criteria is directly searchable:
+
+- **Google dorking** — `"AI CRM" site:linkedin.com/company`
+- **B2B database** — industry, company size, funding, job titles
+
+```typescript
+// Direct: Companies in fintech with 50-500 employees
+const companies = await orangeslice.b2b.sql(`
+  SELECT * FROM linkedin_company 
+  WHERE industry ILIKE '%fintech%'
+    AND employee_count BETWEEN 50 AND 500
+  LIMIT 100
+`);
+```
+
+### 2. Search → Enrich → Qualify
+
+Use when criteria can't be searched directly:
+
+- "Companies that recently switched CRMs"
+- "Are they actively hiring for this role?"
+- "Do they use [specific tool]?"
+
+```typescript
+// 1. Broad search
+const { results } = await orangeslice.serp.search(
+  `"switched to Salesforce" site:linkedin.com/posts`
+);
+
+// 2. Enrich each result
+for (const result of results) {
+  const companyName = extractCompanyFromPost(result);
+  const company = await orangeslice.b2b.sql(`
+    SELECT * FROM linkedin_company WHERE company_name ILIKE '%${companyName}%'
+  `);
+  
+  // 3. Qualify
+  if (company[0]?.employee_count > 100) {
+    // Add to qualified list
+  }
+}
+```
+
+---
+
+## Data Enrichment Pattern
+
+**Standard: Search → Scrape → Extract**
+
+```typescript
+// 1. Find relevant pages
+const { results } = await orangeslice.serp.search(
+  `site:${domain} "practice areas" "medical malpractice"`
+);
+
+// 2. Scrape the top result
+const { markdown } = await orangeslice.firecrawl.scrape(results[0].link);
+
+// 3. Extract structured data
+const data = await orangeslice.generateObject.generate({
+  prompt: `Does this law firm handle medical malpractice cases?\n\n${markdown}`,
+  schema: {
+    type: "object",
+    properties: {
+      handles_med_mal: { type: "boolean" },
+      practice_areas: { type: "array", items: { type: "string" } }
+    }
+  }
+});
+```
+
+### When to Use Each Tool
+
+| Use Search → Scrape → Extract | Use `browser.execute` |
+|------------------------------|----------------------|
+| Data spread across unknown pages | Same template across pages |
+| Varied/unknown page structure | Need specific CSS selectors |
+| One-off enrichment | Scraping lists/tables |
+
+---
+
+## Social Listening
+
+Find posts mentioning topics, brands, or competitors.
+
+### Finding Posts: Use Dorking
+
+```
+# LinkedIn posts mentioning topic
+"AI sales tools" site:linkedin.com/posts
+
+# Twitter/X posts
+"competitor name" site:x.com inurl:status
+
+# Reddit discussions
+"product name" site:reddit.com
+```
+
+### Common Problem: Sellers vs. Complainers
+
+Users want people **complaining about** tools. Searches return mostly **people selling** alternatives.
+
+**Solution: Filter with verification**
+
+```typescript
+const { results } = await orangeslice.serp.search(
+  `"hate Salesforce" OR "frustrated with Salesforce" site:linkedin.com/posts`
+);
+
+for (const post of results) {
+  // Get author info
+  const authorUrl = extractAuthorUrl(post.link);
+  const profile = await orangeslice.b2b.sql(`...`);
+  
+  // Filter out salespeople
+  if (!profile.headline?.toLowerCase().includes('sales')) {
+    // This is likely a real complainer
+  }
+}
+```
+
+---
+
+## Company Research Checklist
+
+```typescript
+async function researchCompany(domain: string) {
+  // 1. Basic company info
+  const company = await orangeslice.b2b.sql(`
+    SELECT * FROM linkedin_company WHERE domain = '${domain}'
+  `);
+  
+  // 2. Leadership team
+  const leadership = await orangeslice.b2b.sql(`
+    SELECT lp.first_name, lp.last_name, pos.title
+    FROM linkedin_profile lp
+    JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+    WHERE pos.linkedin_company_id = ${company[0].id}
+      AND pos.end_date IS NULL
+      AND (pos.title ILIKE 'ceo%' OR pos.title ILIKE 'cto%' OR pos.title ILIKE '%founder%')
+    LIMIT 10
+  `);
+  
+  // 3. Funding history
+  const funding = await orangeslice.b2b.sql(`
+    SELECT * FROM linkedin_crunchbase_funding 
+    WHERE linkedin_company_id = ${company[0].id}
+    ORDER BY announced_date DESC
+  `);
+  
+  // 4. Recent news
+  const news = await orangeslice.serp.search(
+    `"${company[0].company_name}" funding OR acquisition`,
+    { tbs: "qdr:m" }
+  );
+  
+  // 5. Website content
+  const about = await orangeslice.firecrawl.scrape(`https://${domain}/about`);
+  
+  // 6. Current job openings
+  const jobs = await orangeslice.b2b.sql(`
+    SELECT title, locality FROM linkedin_job
+    WHERE linkedin_company_id = ${company[0].id}
+      AND closed_since IS NULL
+    LIMIT 20
+  `);
+  
+  return { company, leadership, funding, news, about, jobs };
+}
+```
+
+---
+
+## Person Research Checklist
+
+```typescript
+async function researchPerson(linkedinUrl: string) {
+  // Extract profile ID from URL
+  const parts = linkedinUrl.split('/in/');
+  const linkedinUserId = parts[1]?.split('/')[0];
+  
+  // 1. Profile info
+  const profile = await orangeslice.b2b.sql(`
+    SELECT * FROM linkedin_profile 
+    WHERE linkedin_user_id = '${linkedinUserId}'
+  `);
+  
+  // 2. Work history
+  const positions = await orangeslice.b2b.sql(`
+    SELECT pos.*, lc.company_name, lc.domain
+    FROM linkedin_profile_position3 pos
+    JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+    WHERE pos.linkedin_profile_id = ${profile[0].id}
+    ORDER BY pos.start_date DESC
+  `);
+  
+  // 3. Recent activity (posts, mentions)
+  const activity = await orangeslice.serp.search(
+    `"${profile[0].first_name} ${profile[0].last_name}" site:linkedin.com`,
+    { tbs: "qdr:m" }
+  );
+  
+  return { profile, positions, activity };
+}
+```
+
+---
+
+## Batch Processing Pattern
+
+For large lists, process in controlled batches:
+
+```typescript
+async function processBatch<T, R>(
+  items: T[],
+  processor: (item: T) => Promise<R>,
+  batchSize = 10
+): Promise<R[]> {
+  const results: R[] = [];
+  
+  for (let i = 0; i < items.length; i += batchSize) {
+    const batch = items.slice(i, i + batchSize);
+    const batchResults = await Promise.all(batch.map(processor));
+    results.push(...batchResults);
+    
+    // Rate limiting is handled by orangeslice, but add delay between batches
+    if (i + batchSize < items.length) {
+      await new Promise(r => setTimeout(r, 1000));
+    }
+  }
+  
+  return results;
+}
+
+// Usage
+const domains = ["stripe.com", "ramp.com", "brex.com", ...];
+const companies = await processBatch(domains, async (domain) => {
+  return orangeslice.b2b.sql(`SELECT * FROM linkedin_company WHERE domain = '${domain}'`);
+});
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "orangeslice",
-  "version": "1.6.1",
-  "description": "Turn any AI agent into a B2B sales research assistant with 1B+ LinkedIn profiles",
+  "version": "1.7.1",
+  "description": "AI agent toolkit: B2B database, SERP, web scraping, browser automation, structured AI output, Apify actors, geocoding",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {