X CRM
A read-only system for finding relevant accounts and posts, managing candidates, tracking followback and analysing the funnel.
Context / task
Working with contacts on X quickly becomes a tangle of manual searches, notes and repeated API calls.
API cost changes, repeated reads get expensive, and automated actions create risk for the account.
What was done
The app leaves actions on the social network to a person and gathers research and records in one interface.
The user runs a limited search, sees the cost estimate before the request, reviews results and selects candidates to import themselves.
The system keeps data provenance, snapshots, actions, followback sync and local analytics.
Key capabilities
- candidate cards and statuses
- configurable scoring across five dimensions
- official X API and a mock provider
- user search with preview before import
- a separate search for fresh posts without automated replies
- caching of fresh data
- daily and monthly API budget guard
- detailed request-cost log
- account snapshot history
- manual and API followback checks
- funnel and conversion analytics
- CSV export
- test scenarios with a mocked X API
Technical side
Next.js App Router, TypeScript, React, Tailwind, Drizzle ORM, SQLite-compatible sql.js, Zod, Recharts and Vitest.
Read-only approach: actions on X are performed by a person, not the system.
The tool is not a mass-following, outreach or auto-reply system.
Project materials
Next case
FitoFrame
Similar task