bisibility README

The project's README from github.com/CorgiCorner/bisibility. As one markdown file: README.md.

bisibility

Own your search visibility data.

bisibility is an open-source SEO platform for researching keywords, inspecting backlinks, and tracking Google rankings - in a PostgreSQL database you own. Self-host it or start with the hosted beta.

CI License: AGPL-3.0-only

Self-hosting guide · Documentation · API reference · FAQ · Roadmap

bisibility dashboard

Dashboard running with demo data.

bisibility is an early release: everything below can be tested today, but expect rough edges and breaking changes before 1.0. Please report installation problems, bugs, and workflow feedback through GitHub Issues.

Why bisibility?

bisibility stays focused on search visibility workflows. It is not a general-purpose technical site-audit, content-writing, or on-page optimization suite.

For rank checks, connect your own DataForSEO or SerpAPI account. Self-hosted deployments keep provider credentials in your instance; the hosted beta stores them encrypted in the managed service. Billing remains directly between you and the provider.

Try the local demo

The local demo is a throwaway evaluation with synthetic data and a fixed, intentionally insecure OTP. It is not a starting point for production. The default stack runs manual rank checks only; recurring schedules add the worker and Temporal.

For prerequisites, the exact bootstrap steps, and how to stop and clean up, follow the local demo quickstart. To compare the demo against hosted and production deployments, see deployment options.

Features

Everything above ships in the current early release; none of it is a stable 1.0 contract yet. The hosted service is in open beta. AI Overview and LLM visibility tracking and hosted general availability are tracked on the roadmap. Slack tenant delivery is available as an API-only preview. Workspace installation and channel management are not yet exposed in the dashboard.

AI agents and MCP

bisibility is API-first. Agents work with the same projects, keywords, checks, alerts, and history that power the dashboard: the REST API, the OpenAPI schema, and the MCP endpoint converge on the same application model, so agent behavior does not rely on dashboard scraping.

For example, connect Codex to a self-hosted instance with a personal access token:

export BISIBILITY_TOKEN="bsb_pat_live_..."
codex mcp add bisibility \
  --url "https://your-host.example/api/mcp" \
  --bearer-token-env-var BISIBILITY_TOKEN

Project API keys work too. Other clients use different configuration fields, but the HTTP connection uses the /api/mcp Streamable HTTP endpoint and an Authorization: Bearer <token> header. The endpoint advertises its tool inventory through the MCP server card; tool names and schemas may change before 1.0. The built-in endpoint and the separately installed @bisibility/mcp package expose the same unprefixed snake_case tools.

See the agent documentation for worked examples, cost-approval guidance, and the CLI and SDKs.

Provider support

Capability DataForSEO SerpAPI
Google rank checks Available Available
Keyword research Available Not supported
Backlink research Available Not supported
Stored normalized SERP snapshot (self-hosted) Available Available
Rank-check cost record Provider reported Configured or estimated

Self-hosting in production

Production deployments need PostgreSQL, Valkey or another Redis-compatible endpoint, and a supported SERP provider account. Scheduled checks additionally require the Temporal worker. Read the self-hosting guide before serving real traffic.

Cost model

Self-hosted bisibility has no application subscription and no per-keyword license fee. You pay separately for the infrastructure you run, SERP requests made through your own provider account, and optional third-party services such as email delivery. bisibility does not resell SERP data. Completed checks store provider-reported cost when available and keep configured or model-based estimates separately. Use the rank-tracking cost calculator before enabling a large schedule.

Architecture

Hosted

The hosted beta runs the same core application without requiring you to operate PostgreSQL, Valkey, or the Temporal worker. It is free during the open beta and does not require a payment method; provider usage is billed directly to your connected provider account. Hosted pricing will be announced before the beta ends, and nothing will be charged without explicit confirmation. Self-hosting remains available without an application subscription.

Documentation

Contributing

Public issues and feature requests are welcome. This repository does not accept pull requests. See CONTRIBUTING.md and CODE_OF_CONDUCT.md.

Security

Do not report vulnerabilities through public issues. See SECURITY.md for responsible disclosure.

License

The Bisibility application and repository content are licensed under AGPL-3.0-only. See LICENSE.

The Claude Code plugin under plugins/bisibility/ is licensed separately under the MIT License. This exception covers that directory and all content beneath it.

You may use, modify, and self-host bisibility. If you modify it and let users interact with that version over a network, the license requires you to offer those users the corresponding source code.

The license text governs. This summary is not legal advice.

bisibility (CorgiCorner/bisibility)

Searching Database…

Что это такое?bisibility — открытая SEO-платформа для исследования ключевых слов, изучения обратных ссылок и отслеживания позиций в поиске Google, причём все данные хранятся в базе PostgreSQL под вашим контролем.
Это облачный SaaS или что-то, что я запускаю сам?Это веб-приложение, которое можно развернуть у себя (дашборд на Next.js плюс REST API) на вашем собственном стеке PostgreSQL/Redis, а можно пользоваться открытой облачной бетой, если не хочется самому обслуживать инфраструктуру.
Как его запустить?Следуйте руководству по самостоятельному развёртыванию, чтобы поднять весь стек, или запустите локальную демку на синтетических данных для быстрого знакомства; в квикстарте локальной демки описаны точные шаги развёртывания и то, как потом всё почистить.
Что нужно для самостоятельного развёртывания в реальной работе?Продакшн-развёртыванию нужны PostgreSQL, хранилище, совместимое с Redis (по умолчанию Valkey), и аккаунт DataForSEO или SerpAPI для данных о позициях, ключевых словах и обратных ссылках; повторяющиеся проверки по расписанию дополнительно требуют Temporal worker.
Достаточно ли это стабильно для продакшна прямо сейчас?Не полностью — это ранний релиз до версии 1.0, так что ломающих изменений и шероховатостей стоит ждать, а локальная демка намеренно использует фиксированный небезопасный OTP, который ни в коем случае нельзя считать годным для продакшна.
Что происходит с учётными данными моего SERP-провайдера?При самостоятельном развёртывании ваши учётные данные DataForSEO или SerpAPI остаются внутри вашего собственного инстанса; в облачной бете они вместо этого хранятся у управляемого сервиса в зашифрованном виде, а биллинг провайдера остаётся напрямую между вами и провайдером.
Могут ли ИИ-агенты работать с bisibility напрямую?Да — он открывает эндпоинт Model Context Protocol на /api/mcp рядом с REST API, так что агенты вроде Codex могут создавать проекты, запускать проверки ключевых слов и читать историю, используя персональный токен доступа или API-ключ проекта.
Какие SDK или CLI-инструменты доступны?Официальные SDK для TypeScript, Python и Go и CLI построены поверх REST API v1 и его OpenAPI-схемы, так что проверки позиций и экспорты можно автоматизировать скриптами, не трогая дашборд.
Стоит ли самостоятельное развёртывание чего-то сверх моих собственных серверов?Никакой подписки на приложение или платы за ключевое слово — вы платите только за свою инфраструктуру и за SERP-запросы через ваш собственный аккаунт DataForSEO или SerpAPI.
Как работает сравнение с конкурентами?bisibility отслеживает Share of Voice относительно конкурентов и может при желании подтягивать метрики Google Search Console и GA4, чтобы сопоставлять движение позиций с деплоями и изменениями в CMS.
Size
20.9 MB
Stars
605
Age
4mo
Commits · 90 Days