# nightcrawler

nightcrawler is a self-hosted ai app. nightcrawler watches marketplaces and shops for new, used and refurbished products. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6916/nightcrawler

## Description

nightcrawler watches marketplaces and shops for new, used and refurbished products. Watchlists run on a schedule; listings are filtered by real specs read from the titles (brand, storage, RAM, CPU, screen, ...) like on Geizhals, with price history, price-drop and sold detection, a deal score and notifications through Apprise (Discord, Telegram, ntfy, e-mail, ...). Sources: the official eBay Browse API (free developer keys), any Shopify store, and any other shop through CSS selectors. Optional AI with your Claude Pro/Max subscription: relevance filter per watchlist in plain language, natural-language search, deal check. Get a token in the container console with: claude setup-token. Then paste it into the template or into Settings > AI in the web UI. Open the web UI after the start. A demo source with test data is set up on the first start. Watchlists, sources and settings are managed in

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 0 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/nightcrawler-0ridihh1foq3ch?q=nightcrawler
- GitHub: https://github.com/hoody424/nightcrawler

## Common questions

### How do I connect nightcrawler to eBay?

Use the official eBay Browse API with free developer keys. eBay is one of the built-in sources you can assign to watchlists.

### Can I watch shops that are not eBay or Shopify?

Yes, use the generic web-page adapter and define CSS selectors for the shop pages. It includes a live test preview and optional AI selector detection.

### How do I enable Claude AI in nightcrawler?

Run `claude setup-token` in the container console to create a token. Paste that token into the template or into Settings > AI in the web UI.

### Which notification services can nightcrawler use?

It sends notifications through Apprise. Supported channels include Discord, Telegram, ntfy, email, Slack, Gotify, and Pushover.

### How are watchlists configured?

Each watchlist has its own query, conditions such as new/used/refurbished, price range, required and excluded words, sources, and schedule.

### Does nightcrawler respect shop rate limits and robots.txt?

It uses per-host rate limits and retries with back-off. It respects robots.txt by default.

---
Source: Our Local Host (https://ourlocalhost.com/app/6916/nightcrawler), the self-hosted and open-source app directory.