explaingit

taisei-ide-0123/harvest

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A command line tool that bulk downloads blog articles, including paywalled ones, as Markdown files for AI agents to use.

Mindmap

mindmap
  root((harvest))
    What it does
      Download articles
      Save as Markdown
      Handle login content
    Tech stack
      TypeScript
      Playwright
      Chrome extension
    Use cases
      Archive blog posts
      Build knowledge bases
      Generate slide decks
    Audience
      Developers
      AI agent builders
    Auth
      Extension fetcher
      Profile fetcher
      Automatic fallback

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

Archive an author's blog articles, including paid ones, as local Markdown files.

USE CASE 2

Feed downloaded articles into an AI agent to build a searchable knowledge base.

USE CASE 3

Generate interactive HTML slide decks from a set of downloaded articles.

USE CASE 4

Run scheduled article downloads headlessly in a CI pipeline using the profile fetcher.

What is it built with?

TypeScriptNode.jsPlaywrightChrome Extension

How does it compare?

taisei-ide-0123/harvest0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing a Playwright Chromium browser and, for gated content, logging in through a browser window first.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

harvest is a command line tool that bulk downloads blog articles and saves them as Markdown files, including articles behind a login or paywall. It is written in TypeScript and currently supports note.com, a Japanese blogging platform, with the README noting that adding support for other sites is straightforward through pull requests. You install it by cloning the repository, running npm install and npm build, linking the CLI package, and installing a Chromium browser through Playwright. To download from a site that requires login, you first run a login command that opens a browser window so you can sign in, and it saves that session for later use. Then a download command pulls every article from a listing page, such as a magazine or author page, and writes each one to an output folder, with options to control output location, concurrency, delay between requests, and a maximum number of articles. Internally, harvest fetches pages in one of two ways. An extension based fetcher connects to a Chrome browser extension over a WebSocket connection and reuses the browser's existing cookies, so no separate login is needed. A profile based fetcher instead launches Playwright with its own persistent browser profile and can run headless, which the README says suits automated agents and continuous integration. By default harvest tries the extension method first and falls back to the profile method automatically. Each supported site has its own adapter that knows how to find article links and parse article content into Markdown, complete with a header containing title, date, source link, author and tags. Beyond downloading, harvest ships with optional skills that let AI coding agents build a searchable knowledge base or generate interactive HTML slide decks from the downloaded articles. These are installed with a setup command and support Claude Code directly, plus a generic AGENTS.md file for tools like Codex, Cursor and Windsurf. The README shows an example workflow of downloading a set of articles, installing the skills, then using an agent to initialize a wiki, ingest the articles in batches, query the resulting knowledge base, and generate slides from a chosen topic. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Install harvest, log in to note.com, and download all articles from a given magazine URL.
Prompt 2
Set up harvest's AI agent skills for Claude Code and initialize a wiki from downloaded articles.
Prompt 3
Use harvest-slides to generate a slide deck from one of the ingested wiki topics.
Prompt 4
Explain the difference between harvest's extension fetcher and profile fetcher.

Frequently asked questions

What is harvest?

A command line tool that bulk downloads blog articles, including paywalled ones, as Markdown files for AI agents to use.

What language is harvest written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Playwright.

What license does harvest use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is harvest to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is harvest for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.