Dozens of OSS scraper libraries launched in 2025-2026 by wrapping Scavio as the hard-backend. This playbook compresses that launch into a 2-week plan: package skeleton, Scavio integration, docs, and a Reddit/HN/Product Hunt launch.
Prerequisites
- Node.js 20+ or Python 3.10+
- A Scavio API key
- GitHub repo
- Basic CI/CD familiarity
Walkthrough
Step 1: Day 1-2: package skeleton
npm init or poetry new, add lint/test/ci boilerplate.
Bash
npm init -y && npm install --save-dev vitest tsup
npm install
mkdir src
touch src/index.tsStep 2: Day 3-5: Scavio adapter
Wrap the Scavio search endpoint as your primary backend.
// src/client.ts
export class Scraper {
constructor(private apiKey: string) {}
async search(query: string) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': this.apiKey, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}
}Step 3: Day 6-8: docs site
MkDocs or Docusaurus with 5 examples + API reference.
Bash
npx create-docusaurus@latest docs classic
# Write: quickstart, search, reddit, amazon, youtubeStep 4: Day 9-11: examples + tests
5 runnable examples + Vitest suite.
// examples/basic.ts
import { Scraper } from '../src';
const s = new Scraper(process.env.SCAVIO_API_KEY!);
console.log(await s.search('hacker news top'));Step 5: Day 12-14: launch
Publish to npm, post to r/programming + HN + Product Hunt.
Bash
npm publish
# Draft a Show HN post highlighting the Scavio-powered simplicityPython Example
Python
import os, requests
class Scraper:
def __init__(self, api_key):
self.api_key = api_key
def search(self, query):
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': self.api_key},
json={'query': query})
return r.json()
s = Scraper(os.environ['SCAVIO_API_KEY'])
print(s.search('hacker news top'))JavaScript Example
JavaScript
export class Scraper {
constructor(apiKey) { this.apiKey = apiKey; }
async search(query) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': this.apiKey, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}
}Expected Output
JSON
OSS library shipped, published, and launched on 3 channels in 14 days. Typical first-week result: 200-800 GitHub stars, 30-100 npm installs.