A Farcaster Frame that scans a user's following list for potentially problematic accounts and provides a detailed report.
- Interactive Frame: A fully interactive Farcaster Frame experience
- Account Scanning: Automatically scans a user's following list
- Moderation Flags: Identifies accounts with potentially problematic content
- Detailed Report: Provides a complete report with flagged accounts
- Modern UI: Clean, modern design with Shadcn-style visuals
- Node.js 18+ and npm
- Neynar API key for Farcaster integration
- Moderation by Design API key for content analysis
- Clone this repository
- Install dependencies:
npm install- Create a
.env.localfile based on.env.example:
cp .env.example .env.local- Add your API keys to the
.env.localfile.
npm run devThe application will be available at http://localhost:3000.
For Frame testing, use the Warpcast Frame Validator.
You can either:
- Use a service like localtunnel to expose your local server:
npx localtunnel --port 3000 - Or deploy to Vercel (see DEPLOYMENT.md)
The entry point for the Frame is at /api/frame.
/src/app/api/frame/route.ts- Main Frame API entry point/src/app/frames/account-scanner/page.tsx- Account scanner implementation/src/app/api/generate-scanner-image/route.ts- Dynamic image generation API/src/lib/farcaster.ts- Farcaster API integration/src/lib/moderation.ts- Content moderation logic/public/assets/- Static assets for Frame images
See DEPLOYMENT.md for detailed deployment instructions.
MIT