Framescan

Framescan is an explorer for navigating and discovering Farcaster frames. Previously, there were no tools to efficiently find all frames ever created... until now! Framescan allows users to search for frames via their names, and access the frame at the click of a button. I plan to add more features to the explorer, such as showing trending frames, frame statistics and so on.

The meat of this project lies in the indexing of the frames. At first, I tried setting up a Hubble instance (via Neynar and then locally), but backfilling the data took too long (beyond the duration of the hackathon), hence I had to figure out other ways. In the end, with the help of the kind souls at Neynar, I managed to use their SQL playground to query for all casts (which was a lot!).

Then, to retrieve all valid frames, I tried to use the Warpcast validator, but with a couple of million urls to validate I was soon rate limited. Hence, I built a custom script using Cheerio to retrieve the meta tags from the urls, check whether it's a valid frame, and save it to my Postgres database. With 1 PC, I only managed to index a few thousand frames thus far :'(

On the frontend, I built it with Next.js, Prisma and Tailwind CSS. Due to the lack of time and in order to have a smooth UX, I'm only displaying about 600 frames, with the option to filter based on the frame title. There's also a separate page for the global top 10 ranked frames according to the API by Karma3Labs, which I used.