whatisgithub

What is spiderfor91?

just-spider/spiderfor91 — explained in plain English

Analysis updated 2026-05-18

12PythonAudience · developerComplexity · 2/5Setup · moderate

In one sentence

SpiderFor91 is a spec sheet and AI prompt template for writing Python crawler scripts that output streaming JSON Lines matching a Go backend's contract.

Mindmap

mindmap
  root((SpiderFor91))
    What it does
      Crawler spec sheet
      AI prompt templates
      No shipped crawlers
    Tech stack
      Python
      JSON Lines stdout
    Use cases
      Write new site crawlers
      Adapt existing scrapers
      Contribute via pull request
    Audience
      Project 91 contributors
      Python developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a new site-specific crawler script using the two provided AI prompt templates.

USE CASE 2

Adapt an existing scraper to stream JSON Lines output instead of writing results at the end.

USE CASE 3

Contribute a new crawler to the Project 91 platform via pull request.

USE CASE 4

Understand the exact job.json and stdout contract a crawler must follow to work with the backend.

What is it built with?

Python

How does it compare?

just-spider/spiderfor91aim-uofa/reasonmatchairbone42/360-data-athlete
Stars121212
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/55/54/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

No runnable code is provided, a developer must write a crawler script following the documented job.json and stdout contract.

The README does not state a license.

So what is it?

SpiderFor91 is a reference guide for writing Python web crawler scripts that plug into a specific video platform called Project 91. The repository does not ship any finished crawlers. What it provides instead are two detailed AI prompt templates: paste the first into any AI assistant to generate code that finds direct video and thumbnail URLs on a target site, then paste the second to add all the structural requirements the Project 91 backend expects. Those structural requirements are precise. Each crawler must be a single Python file with a static name declared at the top. It reads a job description from a JSON file passed on the command line. That job file specifies how many candidate videos to collect, a proxy address for outbound requests, an output directory, and a path to a text file listing video IDs the backend has already processed. The script skips any video whose ID appears in that seen list without re-fetching it. Output works differently from a typical batch scraper. Instead of collecting all results and writing them at the end, each video record must be printed to standard output immediately as it is found, one JSON object per line. Required fields are a stable source ID, a title, and a direct media URL. Thumbnail URLs and request headers for sites that check the referring page are recommended. The backend handles all downloading, deduplication, and storage separately. The project is aimed at developers who want to contribute new site-specific crawlers to the Project 91 platform, or who need to adapt an existing script to the streaming output format the Go backend requires. The README acts as a spec sheet rather than a runnable program. New site requests can go through issues, and finished scripts can be submitted as pull requests.

Copy-paste prompts

Prompt 1
Using the SpiderFor91 spec, write a Python crawler that reads job.json and streams JSON Lines items to stdout.
Prompt 2
Convert this existing Python scraper to follow SpiderFor91's seen_source_ids_file skip logic and candidate_budget limit.
Prompt 3
Explain the required item fields (source_id, title, media_url) SpiderFor91 crawlers must output.
Prompt 4
Show me how to add proxy_url support to a crawler per the SpiderFor91 job.json format.

Frequently asked questions

What is spiderfor91?

SpiderFor91 is a spec sheet and AI prompt template for writing Python crawler scripts that output streaming JSON Lines matching a Go backend's contract.

What language is spiderfor91 written in?

Mainly Python. The stack also includes Python.

What license does spiderfor91 use?

The README does not state a license.

How hard is spiderfor91 to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is spiderfor91 for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.