Skip to content

katyja/serpapi-pycon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Search Signal Board

Search Signal Board is a tiny Streamlit app for the SerpApi raffle challenge. Enter a topic and it uses the SerpApi Python SDK to pull live Google Search and Google News results, then turns those search signals into prototype ideas, repeated terms, related questions, and source links.

It is intentionally small: the goal is a working, explainable conference demo that shows SerpApi being used meaningfully.

What it does

  • Searches Google organic results through SerpApi.
  • Searches Google News through SerpApi.
  • Extracts related questions, related searches, headlines, and source links.
  • Generates a small idea board using simple transparent heuristics.
  • Exports the generated ideas as CSV.

Setup

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Add your SerpApi key to .env:

SERPAPI_API_KEY=your_serpapi_key_here

Then export it before running:

export SERPAPI_API_KEY="$(grep SERPAPI_API_KEY .env | cut -d= -f2)"
streamlit run app.py

If you deploy on Streamlit Community Cloud, add SERPAPI_API_KEY under app secrets.

Usage

  1. Open the Streamlit app.
  2. Enter a topic, such as AI conference networking, Python data dashboards, or local coffee shops.
  3. Click Build board.
  4. Review the generated ideas, search signals, and source links.
  5. Download the ideas CSV if you want to keep the output.

SerpApi usage

The app uses the SerpApi Python SDK in app.py:

import serpapi

client = serpapi.Client(api_key=api_key)
results = client.search(params).as_dict()

It makes two meaningful SerpApi calls:

  • engine=google for organic results, related questions, and related searches.
  • engine=google_news for recent headlines.

Submission notes

This repository includes:

  • App code: app.py
  • Dependencies: requirements.txt
  • Setup instructions: this README
  • Short explanation: this README

A hosted demo can be created by deploying this repo to Streamlit Community Cloud and setting SERPAPI_API_KEY as a secret.

About

SerpAPI Pycon raffle

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages