How to vibe codeSocial Fetch

Prerequisites

• Node.js LTSfree

  Runtime environment for the TypeScript API gateway and Effect framework.

• GitHubfree

  Code repository and CI/CD deployment pipeline.

AI coding tools

• Claude Code

  Best-in-class agentic coding tool for scaffolding the Effect-based API routing layer and writing complex scraper modules.

• Cursor

  Ideal for inspecting scraper diffs and fine-tuning schema validation types.

Build guide

1. 01Scaffold API Gateway & Database Schema

   Initialize a Next.js project with a Turso SQLite database using better-auth for dashboard management and an API key generation schema.

   Scaffold a new Next.js project using TypeScript and Tailwind CSS. Set up Turso database integration using libSQL client. Create database tables for users, API keys (with sfk_ prefix generation), credit balances, and request logs (tracking requestId, endpoint, creditsCharged, and lookupStatus). Integrate better-auth for developer dashboard authentication. Ensure strict type safety and structured error handling throughout the application layout.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Implement Effect-Based Request Pipeline

   Build the core request validation and middleware layer using the Effect framework for typed error management and boundary validation.

   Implement a backend request pipeline using the Effect functional programming framework in TypeScript. Create middleware that extracts and validates the x-api-key header from incoming requests, checks the developer's credit balance in Turso, and enforces rate limits. Build schema-based runtime boundary validation using Effect Schema to guarantee that outgoing JSON responses conform strictly to the standard { data, meta } envelope.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Build Single-Platform Scraper Module (TikTok Profile)

   Develop a robust Playwright-based scraper for TikTok profiles with fallback selectors and proxy rotation logic.

   Develop a robust scraper module for TikTok profiles (GET /v1/tiktok/profiles/{handle}) using Playwright and Axios. Implement proxy rotation middleware supporting external proxy lists with automatic retry logic on failure. Handle upstream rate limits and anti-bot challenges by injecting randomized user agents, viewport settings, and stealth headers. Ensure the output is safely mapped to the normalized JSON schema containing profile metrics, bio, and verification badges.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Add Credit Accounting & Billing Safeguards

   Implement the credit deduction logic with error exemption rules ensuring 503 failures do not debit user balances.

   Implement the credit accounting engine in the API gateway. Configure transactional debiting rules such that successful lookups (including lookupStatus: not_found) deduct exactly 1 credit from the user's balance, while infrastructure failures (lookup_failed, 503 temporarily_unavailable) strictly bypass credit debiting. Include unique requestId generation on every response payload for audit tracing.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Create Developer Documentation & TypeScript SDK

   Publish a lightweight TypeScript SDK mirroring the API routes and provision a developer playground UI.

   Create a companion TypeScript SDK package (@socialfetch/sdk) featuring typed client methods that mirror the implemented REST routes, returning Result types and lookupStatus guards. Build an internal developer dashboard page with an interactive API playground, live request logs showing requestId and credit charges, and a balance top-up view.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for Social Fetch