clawfeed-2

// AI-powered news digest tool. Automatically generates structured summaries (4H/daily/weekly/monthly) from Twitter and RSS feeds.

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

ClawFeed

AI-powered news digest tool. Automatically generates structured summaries (4H/daily/weekly/monthly) from Twitter and RSS feeds.

Credentials & Dependencies

ClawFeed runs in read-only mode with zero credentials — browse digests, view feeds, switch languages. Authentication features (bookmarks, sources, packs) require additional credentials.

Credential	Purpose	Required
`GOOGLE_CLIENT_ID`	Google OAuth login	For auth features
`GOOGLE_CLIENT_SECRET`	Google OAuth login	For auth features
`SESSION_SECRET`	Session cookie encryption	For auth features
`API_KEY`	Digest creation endpoint protection	For write API

Runtime dependency: SQLite via better-sqlite3 (native addon, bundled). No external database server required.

Setup

# Install dependencies
npm install

# Copy environment config
cp .env.example .env
# Edit .env with your settings

# Start API server
npm start

Environment Variables

Configure in .env file:

Variable	Description	Required	Default
`DIGEST_PORT`	Server port	No	8767
`GOOGLE_CLIENT_ID`	Google OAuth client ID	For auth	-
`GOOGLE_CLIENT_SECRET`	Google OAuth client secret	For auth	-
`SESSION_SECRET`	Session cookie encryption key	For auth	-
`API_KEY`	Digest creation API key	For write API	-
`AI_DIGEST_DB`	SQLite database path	No	`data/digest.db`
`ALLOWED_ORIGINS`	CORS allowed origins	No	localhost

API Server

Runs on port 8767 by default. Set DIGEST_PORT env to change.

Endpoints

Method	Path	Description	Auth
GET	/api/digests	List digests (?type=4h\|daily\|weekly&limit=20&offset=0)	-
GET	/api/digests/:id	Get single digest	-
POST	/api/digests	Create digest (internal)	-
GET	/api/auth/google	Start Google OAuth flow	-
GET	/api/auth/callback	OAuth callback endpoint	-
GET	/api/auth/me	Get current user info	Yes
POST	/api/auth/logout	Logout user	Yes
GET	/api/marks	List user bookmarks	Yes
POST	/api/marks	Add bookmark	Yes
DELETE	/api/marks/:id	Remove bookmark	Yes
GET	/api/config	Get configuration	-
PUT	/api/config	Update configuration	-

Web Dashboard

Serve web/index.html via your reverse proxy or any static file server.

Templates

templates/curation-rules.md — Customize feed curation rules
templates/digest-prompt.md — Customize the AI summarization prompt

Configuration

Copy config.example.json to config.json and edit. See README for details.

Reverse Proxy (Caddy example)

handle /digest/api/* {
    uri strip_prefix /digest/api
    reverse_proxy localhost:8767
}
handle_path /digest/* {
    root * /path/to/clawfeed/web
    file_server
}