New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Brightdata Local Search

by davila7 in davila7/claude-code-templates

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

MITAuto-check: notesProductivity & Automation

Install Brightdata Local Search

skills CLI
$ npx skills add davila7/claude-code-templates --skill brightdata-local-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davila7/claude-code-templates brightdata-local-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/development/brightdata-local-search .claude/skills/brightdata-local-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brightdata-local-search
GitHub stars
32k
Token cost
~1.2k tokens
SKILL.md length
408 words
Files
1
Skills in repo
478
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Clone and Configure → Set Environment Variables → Start the Local Server → …
  • Tasks that involve Web search
  • SKILL.md covers Prerequisites, Setup, API Endpoints and Running a Search, plus 3 more sections
  • Calls curl, jq and docker; reaches github.com; needs BRIGHT_DATA_API_TOKEN and ANTHROPIC_API_KEY

What it does

Brightdata Local Search is an agent skill from davila7/claude-code-templates. Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking).

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Web search, Local SEO and Retrieval-augmented generation. It works with Bright Data, SerpApi and Docker. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • Tasks that involve Web search
  • Tasks that involve Local SEO
  • Tasks that involve Retrieval-augmented generation

Example prompts

  • “/brightdata-local-search”

Requirements

  • Node.js
  • Docker
  • A credential in BRIGHT_DATA_API_TOKEN
  • A credential in ANTHROPIC_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Clone and Configure
  2. Set Environment Variables
  3. Start the Local Server
  4. Submit Search
  5. Poll for Results

What it can do on your machine

Read from SKILL.md and the folder at commit 46b4d8b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq
    • docker
    • pnpm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • brightdata.com
    • console.anthropic.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BRIGHT_DATA_API_TOKEN
    • ANTHROPIC_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brightdata Local Search loads about 1.2k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 408 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:25
    cp .env.example .env
  • NoteMentions a .env fileSKILL.md:30
    Edit `.env` with your credentials:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davila7/claude-code-templates at commit 46b4d8b, republished under its MIT licence (© davila7). 408 words, ~1,224 tokens.

Download SKILL.mdSave it as .claude/skills/brightdata-local-search/SKILL.md (or your agent's skills folder).
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).

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

Setup

Step 1: Clone and Configure
bash
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:

env
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):

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

Node.js:

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

API Endpoints

All requests go to http://localhost:3000:

EndpointMethodDescription
/api/searchPOSTStart a search job
/api/search-status/{jobId}GETPoll for results
/api/baselinePOSTTrigger baseline collection
/api/baseline-status/{id}GETPoll baseline progress
bash
curl -X POST http://localhost:3000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "your search term"}'

The response returns a jobId.

Step 2: Poll for Results
bash
curl http://localhost:3000/api/search-status/{jobId}

Poll every 3 seconds until status is "done".

Search Parameters
ParameterTypeDefaultDescription
querystringrequiredSearch query
expandbooleanfalseEnable AI query expansion via Claude
researchbooleanfalseResearch mode (12 sub-queries for max coverage)
enginesstring[]allSERP engines to use
geostring—Geographic region filter
countnumber10Max results (up to 10)
includeDomainsstring[]—Only include results from these domains
excludeDomainsstring[]—Exclude results from these domains
Search Modes
  • Basic (expand: false): Single query, fastest, no AI cost
  • Expanded (expand: true): Claude Haiku generates 3 sub-queries for broader coverage
  • Research (research: true): 12 sub-queries for maximum coverage
Show full SKILL.md (149 more words)Show less

Usage Examples

Basic Search from an Agent
bash
# 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
Research Mode with Domain Filtering
bash
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"]
  }'
Adding Search to an Existing Agent

To give your Claude Code agent search capabilities:

  1. Ensure the local server is running (docker compose up -d in the unfancy-search directory)
  2. Your agent can use curl or fetch to query http://localhost:3000/api/search
  3. Parse the ranked results to ground responses with real web data

Response Format

Results include:

  • Ranked URLs with RRF scores
  • Domain clustering (grouped by source)
  • Cost transparency (per-search expense breakdown)
  • Raw and unique result counts
  • Search duration

Troubleshooting

IssueSolution
Server won't startVerify Docker is running or Node.js 18+ installed
No results returnedCheck BRIGHT_DATA_API_TOKEN is valid and SERP API zone is active
Query expansion not workingVerify ANTHROPIC_API_KEY is set and valid
Slow responsesDisable expand mode for faster single-query searches
Port 3000 in useStop other services or modify the port in docker-compose.yml

© davila7, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-tool/components/skills/development/brightdata-local-search of davila7/claude-code-templates.

Open the folder on GitHubat commit 46b4d8b

Compare with similar skills

Brightdata Local Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brightdata Local Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brightdata Local Search this skilldavila7/claude-code-templates32k—~1.2kAutomated safety check: NotesMIT
Discover APIbrightdata/skills264—~2.4kAutomated safety check: PassMIT
Serp AnalyzerOpenClaudia/openclaudia-skills713—~3.6kAutomated safety check: PassMIT
SEO Watchlistzubair-trabzada/dataforseo-claude164—~873Automated safety check: NotesMIT
Live Researchbrightdata/skills264—~1.8kAutomated safety check: PassMIT
Bright Data Best Practicesbrightdata/skills2641 repos~3.6kAutomated safety check: PassMIT

Similar skills

  • Discover API

    brightdata/skills

    Use Bright Data's Discover API — intent-ranked, AI-relevance-scored web search at scale (not keyword SERP).

    264 GitHub stars~2.4k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed

  • Serp Analyzer

    OpenClaudia/openclaudia-skills

    Analyze Google search results (SERP) for any keyword. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~3.6k tokensUpdated 21 days ago
    Productivity & AutomationAuto-check passed

  • SEO Watchlist

    zubair-trabzada/dataforseo-claude

    Track multiple domains and keywords across runs using the DataForSEO SERP API.

    164 GitHub stars~873 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check: notes

  • Live Research

    brightdata/skills

    Produce a deep, multi-source, cited research brief on a topic from live web data using Bright Data's Discover API (intent-ranked web search + parsed page content).

    264 GitHub stars~1.8k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed

  • Bright Data Best Practices

    brightdata/skills

    Build production-ready Bright Data integrations with best practices baked in.

    264 GitHub starsUsed in 1 repo~3.6k tokens
    Data & AnalyticsAuto-check passed

  • RAG Pipeline

    brightdata/skills

    Build a RAG (retrieval-augmented generation) pipeline or a custom search engine on top of Bright Data's Discover API — using intent-ranked web results + parsed page content as the…

    264 GitHub stars~1.9k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed

More from davila7/claude-code-templates

All 478 skills in this repo

  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    32k GitHub starsUsed in 11 repos~3.5k tokens
    Auto-check: notes

  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    32k GitHub starsUsed in 9 repos~2.8k tokens
    Auto-check passed

  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    32k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes

  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed

  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    32k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Works with

Categories

Questions about Brightdata Local Search

What does Brightdata Local Search do?

Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking). Brightdata Local Search is an agent skill from davila7/claude-code-templates. Set up and run local web searches using Bright Data SERP API with the unfancy-search pipeline (query expansion, SERP retrieval, RRF reranking).

When should I use Brightdata Local Search?

Brightdata Local Search fits situations like: tasks that involve Web search; tasks that involve Local SEO; tasks that involve Retrieval-augmented generation.

How do I install Brightdata Local Search in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill brightdata-local-search -a claude-code`. Or copy the skill folder (cli-tool/components/skills/development/brightdata-local-search in davila7/claude-code-templates) into .claude/skills/brightdata-local-search in your project. Claude Code loads it when a task matches its description.

How do I install Brightdata Local Search in Codex?

Run `npx skills add davila7/claude-code-templates --skill brightdata-local-search -a codex`. Or copy the skill folder (cli-tool/components/skills/development/brightdata-local-search in davila7/claude-code-templates) into .agents/skills/brightdata-local-search in your project. Codex loads it when a task matches its description.

Can I use Brightdata Local Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davila7/claude-code-templates --skill brightdata-local-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brightdata-local-search, .gemini/skills/brightdata-local-search, .github/skills/brightdata-local-search and .opencode/skills/brightdata-local-search in your project.

What does Brightdata Local Search need to run?

Going by SKILL.md and its folder, Brightdata Local Search needs the command-line tools its instructions call (curl, jq, docker, pnpm and git) and credentials named BRIGHT_DATA_API_TOKEN and ANTHROPIC_API_KEY. Our summary lists: Node.js; Docker; A credential in BRIGHT_DATA_API_TOKEN; A credential in ANTHROPIC_API_KEY.

Does Brightdata Local Search access the network?

SKILL.md names 3 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: brightdata.com and console.anthropic.com. This is read from the text; nothing was executed.

Is Brightdata Local Search safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Brightdata Local Search use?

Brightdata Local Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brightdata Local Search use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brightdata Local Search?

Skills that share tags, products or a category with Brightdata Local Search: Discover API (brightdata/skills, 264 stars), Serp Analyzer (OpenClaudia/openclaudia-skills, 713 stars), SEO Watchlist (zubair-trabzada/dataforseo-claude, 164 stars) and Live Research (brightdata/skills, 264 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brightdata Local Search?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,483 GitHub stars. The repository holds 478 skills in this directory. The repository was last updated on October 9, 2026.

Source: davila7/claude-code-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.