Clawfeed

AI tool that generates structured news digests from Twitter and RSS feeds with summaries available in 4-hour, daily, weekly, or monthly formats.

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
}