Skip to main content

SERP.fyi: FAQ Engine 🔎🤖

npm PyPI DOI Docs License

SERP.fyi FAQ Engine answers questions about SERP.fyi in plain English. Ask about real-time rank tracking, AI visibility audits, ChatGPT and Perplexity mentions, entity recognition, local SEO, SERP features, reports or getting started, and the engine returns the best official answer from 40 SERP.fyi FAQs with a confidence score from 0 to 100. Built by SERP.fyi.

Overview

SERP.fyi is a search intelligence platform that combines real-time Google search tracking with AI visibility audits. This repository publishes its 40 official FAQs as structured, machine-readable data and ships a lightweight question-matching engine for Node.js (NPM) and Python (PyPI), so the same answers can power help centers, chat widgets, support tools and AI assistants.

The engine has no external dependencies and makes no network calls. It tokenizes the question, maps SEO synonyms (for example rankings to rank or ChatGPT to AI), scores every FAQ by weighted keyword overlap, and returns the strongest matches.

Key Capabilities

  • Plain-English Matching: Ask in your own words and get the closest official SERP.fyi answer
  • Confidence Scoring: Every answer carries a 0 to 100 match-confidence score and band
  • 40 Official FAQs: 15 platform FAQs and 25 feature and technical FAQs across 7 categories
  • SEO-Aware Synonyms: Rankings, positions, LLM names, AI Overviews, local packs and more
  • Top-N Results: Return the best 1, 3 or more answers for a question
  • Two Runtimes: Identical results from the Node.js (TypeScript) and Python implementations
  • JSON Output: Machine-readable results for widgets and integrations
  • FAQPage Schema: All 40 FAQs as JSON-LD structured data in schema.json

FAQ Categories

Category Covers FAQs
general What SERP.fyi is, who it is for and how it differs 5
ai-visibility AI visibility audits, citations and entity recognition 9
rank-tracking Real-time rank tracking, devices, locations and accuracy 8
local-seo Local search, local packs and heatmaps 2
serp-features SERP features, zero-click searches and signal mapping 3
reports-dashboard Reports, exports, white-label and the unified dashboard 9
getting-started Getting started, privacy and support 4

Quick Start

Node.js

npm install @serp-fyi/serp-faq-engine
npx serp-faq "does serp.fyi track chatgpt mentions"
npx serp-faq --top 3 "can I track mobile rankings"
npx serp-faq --list ai-visibility

Python

pip install serp-faq-engine
serp-faq "can agencies white label reports"
python -m faq_engine --json "how often is data updated"

In code

import faq_engine

print(faq_engine.ask("is my data private"))
print(faq_engine.search("local pack heatmap", top=3))
const { ask, search } = require("@serp-fyi/serp-faq-engine");

console.log(ask("what are serp features"));

CLI Options

Option Output
"question" Best matching answer
--top N "question" Top N answers
--json "question" Results as JSON
--list [category] All questions, or one category
--id N One FAQ by number (1 to 40)
--categories Categories and FAQ counts

Example Matches

Question asked Matched FAQ Confidence
"does it track chatgpt mentions" Q29 92
"can I track mobile rankings" Q20 100
"can agencies white label reports" Q35 100
"how often is data updated" Q25 92
"who made serp.fyi" Q15 100

Score Interpretation

Score Band Meaning
0 to 30 No match Rephrase the question or contact support
31 to 60 Possible match Answer may be related; check the question shown
61 to 80 Good match Answer is likely what you need
81 to 100 Strong match Answer directly addresses the question

Dataset

dataset/serp_faqs.csv holds all 40 FAQs with id, category, part, question, answer and keywords columns. A walkthrough notebook is in kaggle/notebook.ipynb.

Repository Description
serp-fyi-serp-tracker Track keyword rankings, SERP features and AI Overview visibility across Google, Bing, ChatGPT and Perplexity
SERP-Checker-Tool Analyze search results in real time with a TypeScript and Python SERP checker

Keywords

SERP.fyi · SERP FAQ · Search Intelligence · Real-Time Rank Tracking · AI Visibility Audit · AI Overviews · ChatGPT Brand Mentions · Entity Recognition · Local SEO · SERP Features · LLM Signal Mapping

Platform URL
Website https://serp.fyi
SERP Checker https://serp.fyi/serp-checker/
Local SEO & AIVO Audit https://serp.fyi/local-seo-and-avio-audit/
GitHub https://github.com/SERP-fyi/serp-faq-engine
GitHub Pages https://serp-fyi.github.io/serp-faq-engine/
NPM https://www.npmjs.com/package/@serp-fyi/serp-faq-engine
PyPI https://pypi.org/project/serp-faq-engine/
Hugging Face https://huggingface.co/datasets/serp-fyi/serp-faq-dataset
Kaggle https://www.kaggle.com/datasets/serpfyi/serp-faq-dataset
Zenodo https://zenodo.org/records/23827126
Docs https://serp-faq-engine.readthedocs.io

Company Profiles

Platform URL
GoodFirms https://www.goodfirms.co/company/serpfyi
SuperbCompanies https://superbcompanies.com/organizations/serp-fyi/
ProvenExpert https://www.provenexpert.com/serp-fyi/
Glassdoor https://www.glassdoor.co.in/Overview/Working-at-SERP-fyi-EI_IE11124673.11,19.htm

About SERP.fyi

SERP.fyi is a search intelligence platform built for SEO professionals, digital marketing agencies, brand managers and CMOs. It combines real-time Google search tracking with AI visibility audits that show how search engines and AI systems such as ChatGPT, Perplexity and Google AI Overviews understand a brand. SERP.fyi is developed as part of the BHMarketer ecosystem.

License

MIT, SERP.fyi

Metadata

Release files for serp-faq-engine 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for serp-faq-engine 1.0.0
File Size Uploaded Provenance Actions
serp_faq_engine-1.0.0.tar.gz 13.0 kB Without provenance Details for serp_faq_engine-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for serp-faq-engine 1.0.0
File Interpreter ABI Platform Actions
serp_faq_engine-1.0.0-py3-none-any.whl Python 3 none any Details for serp_faq_engine-1.0.0-py3-none-any.whl

Total release size: 24.7 kB

Release files / serp_faq_engine-1.0.0.tar.gz

Download URL serp_faq_engine-1.0.0.tar.gz
Size 13.0 kB
Tags Source
SHA-256 checksum
How to use checksums
1c9935957675139c0771604314553ed569d43f0d1b8f1c9736dd4ec728920bd1
BLAKE2b-256 checksum
How to use checksums
655476385f8c78500fb4c814919f8d5e995826c7665bb4cc8ef64e60a744c902
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / serp_faq_engine-1.0.0-py3-none-any.whl

Download URL serp_faq_engine-1.0.0-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
39eabcbb29df56d714e25517e22bd72c986a189c3c8cc31a190f4dd051561a00
BLAKE2b-256 checksum
How to use checksums
00aa8d598fd6653c153f68ff34316d0217a7a3e66573d40f2325899c14a9389c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for serp-faq-engine 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page