whatisgithub

What is local-client-prospector-skill?

kappaemme-git/local-client-prospector-skill — explained in plain English

Analysis updated 2026-05-18

131JavaScriptAudience · pm founderComplexity · 2/5Setup · easy

In one sentence

A Codex skill that searches for local businesses lacking a proper website and scores them as sales leads.

Mindmap

mindmap
  root((repo))
    What it does
      Finds local businesses
      Checks website status
      Scores leads
    Tech stack
      JavaScript
      Codex skill
      npm install
    Use cases
      Local prospecting
      Lead export to XLSX
    Audience
      Freelancers
      Agencies
      Consultants

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find local gyms, shops, or clinics within a set radius that lack a proper website.

USE CASE 2

Export a lead list to XLSX with lead scores, contact info, and notes for outreach.

USE CASE 3

Quickly triage prospects into Hot, Warm, Low, or Skip categories before contacting them.

What is it built with?

JavaScriptCodexnpm

How does it compare?

kappaemme-git/local-client-prospector-skillbuynao/aipathsveltejs/esrap
Stars131131136
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-27
MaintenanceActive
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencepm foundergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

So what is it?

Local Client Prospector is a Codex skill, meaning it is an add-on for the Codex AI assistant, built to help freelancers, agencies, or small business consultants find potential clients. Instead of searching manually for local shops, gyms, restaurants, salons, or clinics that might need a website or a better online presence, this tool automates the search using browser-assisted research. Once installed, it looks up nearby businesses and checks whether each one already has a proper standalone website or only relies on social media pages. Based on what it finds, it assigns each business a lead score of Hot, Warm, Low, or Skip, giving the user a quick sense of which prospects are worth contacting first. The results come back as a table readable directly in chat, or in CSV-style rows that are easy to paste into a spreadsheet. It also works alongside Codex's spreadsheet skill, so results can be exported straight into an XLSX file with columns for phone number, website, social links, source, and notes. Getting started is simple: running one command, npx local-client-prospector-skill, installs the skill into the Codex skills folder, and it becomes available the next time Codex starts. From there, a user can type a plain language request, such as asking for gyms and shops within a set distance of a specific location, and the skill returns a formatted lead list, replying in whatever language the request was written in. The project describes itself as an assisted research tool rather than a scraper meant for pulling large volumes of data automatically. It is built to check public information responsibly and cross-reference business details rather than bypass any access restrictions, which suggests it is aimed at small-scale, targeted prospecting rather than mass data collection. This could be useful for freelance web designers, marketing consultants, or small agencies looking for local businesses that lack a proper online presence and might want help building one. The README is fairly short and focused mainly on installation and usage instructions, without much detail on the underlying technical implementation.

Copy-paste prompts

Prompt 1
Use $local-client-prospector to find restaurants within 15km of downtown that may need a website, and show the results in chat.
Prompt 2
Use $local-client-prospector and $spreadsheets to find gyms within 20km of my city, and create an XLSX with lead scores and contact info.
Prompt 3
Use $local-client-prospector to find salons near my area that only have social media pages and no real website.
Prompt 4
Use $local-client-prospector to list local clinics within 10km, ranked by lead score, in a CSV-style table.

Frequently asked questions

What is local-client-prospector-skill?

A Codex skill that searches for local businesses lacking a proper website and scores them as sales leads.

What language is local-client-prospector-skill written in?

Mainly JavaScript. The stack also includes JavaScript, Codex, npm.

How hard is local-client-prospector-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is local-client-prospector-skill for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.