# SerpBear

SerpBear is an open-source search engine position tracking application that monitors your website's keyword rankings in Google and notifies you when their positions change. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1215/serpbear

## Description

SerpBear is an open-source search engine position tracking application that monitors your website's keyword rankings in Google and notifies you when their positions change. It supports unlimited domains and keywords, sends daily, weekly, or monthly email alerts, and exposes a SERP (search engine results page) API for keyword research, making it a self-hosted ranking and monitoring tool for site owners tracking organic search visibility. A third-party scraping service or proxy is required to query Google's search results.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

58/100 (Fair), based on 4 of 5 factors.
- Maintained: 59 (last commit 162 days ago)
- Popular: 66 (2,102 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 70 (no serious findings, 15 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/towfiqi/serpbear
- Unraid: https://ca.unraid.net/apps/serpbear-0evclgc0h6xkrk?q=SerpBear
- Official website: https://docs.serpbear.com/
- Documentation: https://docs.serpbear.com/getting-started

## Common questions

### Which credentials and environment variables must be set before running SerpBear?

Create .env.local with the admin username and password, a secret key of at least 32 characters, the scraper service name and API key, and optional Google Search Console credentials. Missing or wrong values can block sign-in, result fetching, and Search Console features.

### Does SerpBear need a third-party scraper or proxy to fetch Google rankings?

Yes, it uses third-party scrapers or proxy IPs to scrape Google search results for a certain keyword and check your domain.

### Which file should be backed up to preserve site and keyword settings?

Keep a copy of data/settings.json because it stores your site and keyword settings. If it becomes corrupted, SerpBear may not load your settings, though it may save a backup copy for recovery.

### What Google Search Console credentials are required for Search Console stats?

Enter the service-account email and private key for the Google account whose Search Console data SerpBear should read. Without those credentials, Search Console features will not show clicks, impressions, or average position.

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