brightdata-local-search

Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking).

Zur Installation springen

Repository: davila7/claude-code-templates
Letzte Quellaktivität: 18. März 2026 um 03:47
Erkannte Sprache von SKILL.md: Englisch
Sterne: 30.229
Forks: 3.394

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Zurück zur Suche Zurück zur Installation

name	brightdata-local-search
description	Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking).

Bright Data Local Search

Run powerful web searches locally using Bright Data's SERP API. This skill sets up the unfancy-search pipeline — a local search engine with query expansion, multi-engine SERP retrieval, RRF reranking, deduplication, and domain clustering.

Important: This skill uses the LOCAL version only. Do not use the hosted endpoint.

Prerequisites

Bright Data account with SERP API access
Anthropic API key (for query expansion, optional)
Docker (recommended) or Node.js 18+ with pnpm

Setup

Step 1: Clone and Configure

git clone https://github.com/yaronbeen/unfancy-search.git
cd unfancy-search
cp .env.example .env

Step 2: Set Environment Variables

Edit .env with your credentials:

BRIGHT_DATA_API_TOKEN=your_brightdata_token
BRIGHT_DATA_SERP_ZONE=serp_api1
ANTHROPIC_API_KEY=your_anthropic_key   # Optional: enables AI query expansion

Get your Bright Data token from: https://brightdata.com (SERP API section)

Step 3: Start the Local Server

Docker (recommended):

docker compose up -d
# Server runs at http://localhost:3000

Node.js:

pnpm install
pnpm dev
# Server runs at http://localhost:3000

curl -X POST http://localhost:3000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "your search term"}'

curl http://localhost:3000/api/search-status/{jobId}

Parameter	Type	Default	Description
`query`	string	required	Search query
`expand`	boolean	`false`	Enable AI query expansion via Claude
`research`	boolean	`false`	Research mode (12 sub-queries for max coverage)
`engines`	string[]	all	SERP engines to use
`geo`	string	—	Geographic region filter
`count`	number	10	Max results (up to 10)
`includeDomains`	string[]	—	Only include results from these domains
`excludeDomains`	string[]	—	Exclude results from these domains

# Start search
JOB_ID=$(curl -s -X POST http://localhost:3000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "best practices for API rate limiting"}' | jq -r '.jobId')

# Poll until done
while true; do
  RESULT=$(curl -s http://localhost:3000/api/search-status/$JOB_ID)
  STATUS=$(echo $RESULT | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo $RESULT | jq '.results'
    break
  fi
  sleep 3
done

curl -X POST http://localhost:3000/api/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "kubernetes scaling strategies",
    "research": true,
    "excludeDomains": ["pinterest.com", "quora.com"]
  }'

Issue	Solution
Server won't start	Verify Docker is running or Node.js 18+ installed
No results returned	Check `BRIGHT_DATA_API_TOKEN` is valid and SERP API zone is active
Query expansion not working	Verify `ANTHROPIC_API_KEY` is set and valid
Slow responses	Disable `expand` mode for faster single-query searches
Port 3000 in use	Stop other services or modify the port in docker-compose.yml