Practical overview
When it fits
Use it when you want a CLI-based way to turn Search Console records into a local semantic-retrieval collection and investigate them with AI, or to add a page-level content comparison.
Who it is for
- Site owners and SEO practitioners with access to Google Search Console data.
- Technical users comfortable configuring a Python project, cloud service-account credentials and API keys.
Documented uses
- Retrieve up to 16 months of Search Console queries, pages, dates, countries and devices.
- Ask semantic questions about stored search performance, including query trends and possible cannibalization.
- Audit an individual page against its GSC queries and competing pages using optional Parallel.ai research.
Requirements & limits
The project is a public GitHub repository intended for local setup. It requires a Gemini API key and Google service-account access to a Search Console property. The README lists Gemini's free tier, pay-per-use options for Grok and Claude, and pay-per-use Parallel.ai research; actual costs depend on provider use.
- The primary workflow is a Python CLI, not a hosted web dashboard.
- Google Search Console access and a service-account JSON key are required for data extraction.
- Gemini embeddings are required; Grok and Claude are alternative analysis providers with separate credentials.
- Page audits and competitor analysis depend on an optional Parallel.ai key.
- ChromaDB stores the vector collection locally, while model analysis and optional web research use external providers.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Vectordb Gsc and configure Google access
Prepare the project and credentials needed for its documented Search Console workflow.
Before you start
- Python and the ability to install the repository's requirements.
- A Google Cloud service account, enabled Search Console API, and permission to access the target Search Console property.
- A Gemini API key.
Steps
Clone the repository and install dependencies with the command below.
pip install -r requirements.txtPlace the service-account JSON key file in the project root, enable the Search Console API, and add the service-account email to the property's Search Console users.
Copy
.env.exampleto.envand setSERVICE_ACCOUNT_FILEandGEMINI_API_KEY; setGSC_PROPERTYor leave it blank for the property picker.
Expected outcome
The project has its documented dependencies and Google and Gemini credentials configured for subsequent commands.
Guide limitations
- This setup guide does not establish that extraction or analysis has been run.
- The documented setup requires credentials and access to a Search Console property.
Extract, embed and query Search Console records
Use the documented CLI stages to prepare GSC records for semantic analysis.
Before you start
- A configured project with Search Console property access and Gemini API key.
- The repository's Python dependencies installed.
Steps
Run the command below to retrieve the documented 16-month range of GSC performance data.
python main.py extractRun the command below to aggregate rows into query–page documents, calculate metrics and embed records in ChromaDB.
python main.py processRun the command below for the interactive analyses, or use the command below for a one-shot question.
python main.py analyzepython main.py ask "which queries are rising fastest?"
Expected outcome
The documented workflow extracts and embeds GSC records locally, then retrieves relevant records to support AI analysis.
Guide limitations
- Gemini is required for embeddings; Grok and Claude require their own keys when selected.
- The README describes a local ChromaDB store and external model providers; it does not describe this as a hosted dashboard.
Compare options for Retrieval-augmented applications
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Vectordb Gsc | Retrieve up to 16 months of Search Console queries, pages, dates, countries and devices. | CLI, Self-hosted | The project is a public GitHub repository intended for local setup. It requires a Gemini API key and Google service-account access to a Search Console property. The README lists Gemini's free tier, pay-per-use options for Grok and Claude, and pay-per-use Parallel.ai research; actual costs depend on provider use. |
| Rag Powered AI Assistant Transforming Data Retrieval And Analysis Across The Web And Pdfs | Retrieve relevant passages from web and PDF content to answer a question. | Web | |
| LangChain in Supabase Edge Functions | Initialize and start a Supabase project locally. | Cloud, Server |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- metehan777/vectordb-gsc · Official homepage title · retained in its source language

