sales-nav-search-builder

Name: sales-nav-search-builder
Author: LaGrowthMachine

58installs4forks

How to install sales-nav-search-builder?

lagrowthmachine/gtm-system/sales-nav-search-builder

$npx -y skills add LaGrowthMachine/gtm-system --skill sales-nav-search-builder

Installs into the current project.

Summary

Generate a precise LinkedIn Sales Navigator search URL from a natural-language ICP description — for sales prospecting, outbound outreach, lead generation, and B2B targeting. Use whenever the user asks for a Sales Nav URL, a LinkedIn search URL, an outbound prospecting query, a s

Files · 1

View on GitHub

SKILL.md

1	# Sales Nav Search Builder
2
3	Converts a natural-language ICP description into a ready-to-click LinkedIn Sales Navigator search URL, including boolean strings for the title and keyword fields. Maintained by [La Growth Machine](https://lagrowthmachine.com).
4
5	## Authority — read this first
6
7	This file is the canonical reference for everything you need to build a Sales Nav URL. The inline tables, presets, and rules below are exhaustive for common B2B targeting. The files in `references/` exist for the long tail.
8
9	You do NOT need to consult these files — they're already inlined here:
10	- `references/spec-schema.md` → full spec format is below
11	- `references/boolean-search.md` → operators, hard rules, patterns, decision tree are below
12	- `scripts/validate_boolean.py` → the operator limit is 15 per field, the script auto-validates, no need to read its code
13	- `references/geo-locations.md` → not needed for queries (only for extending regions.json)
14
15	The visual handoff (widget HTML + post-click decision tree) is inlined at the bottom of this file — no separate file to consult.
16
17	Consult `references/industries.json` ONLY when the user names an industry that's not in the top-10 table or in an industry preset below (e.g., "semiconductor manufacturing", "maritime shipping", "veterinary services").
18
19	Consult `references/regions.json` ONLY when the user names a country that's not in the top-30 table or in a region preset below (e.g., "Kazakhstan", "Senegal", "Trinidad").
20
21	If you find yourself running a `grep` or bash script to find an industry or region ID, stop — check the presets section first. The presets are designed to cover the way B2B sellers actually think about geography ("EMEA", "DACH", "Nordics") and verticals ("SaaS", "FinTech", "HRTech").
22
23	## Workflow
24
25	1. Build a JSON spec using the inline content below.
26	2. Pipe the spec to the builder via stdin and capture the URL:
27	```bash
28	echo '<JSON_SPEC>' \| python3 scripts/build_url.py -
29	```
30	3. Output the visual handoff — a brief framing line followed by `visualize:show_widget`. See "Output format" at the end of this file. This step is mandatory and replaces any text-based summary. Do not paste the URL or explain segmentation choices in prose.
31
32	The script validates IDs against reference files, runs boolean validation on text fields, and refuses to build invalid URLs.
33
34	## Spec format (complete)
35
36	```json
37	{
38	"filters": [
39	{"type": "INDUSTRY", "values": [{"id": 4, "selectionType": "INCLUDED"}]},
40	{"type": "FUNCTION", "values": [{"id": 15, "selectionType": "INCLUDED"}]},
41	{"type": "REGION", "values": [{"id": 105015875, "selectionType": "INCLUDED"}]},
42	{"type": "CURRENT_TITLE", "values": [{"text": "(CMO OR \"Chief Marketing Officer\") NOT Fractional", "selectionType": "INCLUDED"}]},
43	{"type": "RECENTLY_CHANGED_JOBS", "toggle": true}
44	]
45	}
46	```
47
48	Field rules (complete — do not consult spec-schema.md):
49	- `type` — one of the filter types listed below.
50	- `values` — array of value objects.
51	- `id` — for ID-based filters. Integer for most enums; single-letter string for `COMPANY_HEADCOUNT` and `COMPANY_TYPE`; 2-letter code for `PROFILE_LANGUAGE`.
52	- `text` — for text-only filters (`FIRST_NAME`, `LAST_NAME`, `CURRENT_TITLE`, `PAST_TITLE`, `KEYWORDS`). Auto-resolved for ID-based filters — omit it there.
53	- `selectionType` — `"INCLUDED"` (default) or `"EXCLUDED"`. Use `EXCLUDED` when the user says "exclude", "except", "not", "without".
54	- `toggle: true` — shortcut for toggle filters; the builder auto-fills the hardcoded ID.
55
56	When a user targets multiple values of the same filter type (e.g., "France, Germany, Italy"), put them all in one filter object's `values` array — LinkedIn applies OR within a filter and AND across filters.
57
58	## Region presets (USE THESE for multi-country targeting)
59
60	B2B sellers think in regional groupings, not individual countries

People who liked this also viewed

6 picks

Type

sales-nav-search-builder

58installs4forks

View on GitHub

How to install sales-nav-search-builder?

lagrowthmachine/gtm-system/sales-nav-search-builder

$npx -y skills add LaGrowthMachine/gtm-system --skill sales-nav-search-builder

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Sales Nav Search Builder
2
3	Converts a natural-language ICP description into a ready-to-click LinkedIn Sales Navigator search URL, including boolean strings for the title and keyword fields. Maintained by [La Growth Machine](https://lagrowthmachine.com).
4
5	## Authority — read this first
6
7	This file is the canonical reference for everything you need to build a Sales Nav URL. The inline tables, presets, and rules below are exhaustive for common B2B targeting. The files in `references/` exist for the long tail.
8
9	You do NOT need to consult these files — they're already inlined here:
10	- `references/spec-schema.md` → full spec format is below
11	- `references/boolean-search.md` → operators, hard rules, patterns, decision tree are below
12	- `scripts/validate_boolean.py` → the operator limit is 15 per field, the script auto-validates, no need to read its code
13	- `references/geo-locations.md` → not needed for queries (only for extending regions.json)
14
15	The visual handoff (widget HTML + post-click decision tree) is inlined at the bottom of this file — no separate file to consult.
16
17	Consult `references/industries.json` ONLY when the user names an industry that's not in the top-10 table or in an industry preset below (e.g., "semiconductor manufacturing", "maritime shipping", "veterinary services").
18
19	Consult `references/regions.json` ONLY when the user names a country that's not in the top-30 table or in a region preset below (e.g., "Kazakhstan", "Senegal", "Trinidad").
20
21	If you find yourself running a `grep` or bash script to find an industry or region ID, stop — check the presets section first. The presets are designed to cover the way B2B sellers actually think about geography ("EMEA", "DACH", "Nordics") and verticals ("SaaS", "FinTech", "HRTech").
22
23	## Workflow
24
25	1. Build a JSON spec using the inline content below.
26	2. Pipe the spec to the builder via stdin and capture the URL:
27	```bash
28	echo '<JSON_SPEC>' \| python3 scripts/build_url.py -
29	```
30	3. Output the visual handoff — a brief framing line followed by `visualize:show_widget`. See "Output format" at the end of this file. This step is mandatory and replaces any text-based summary. Do not paste the URL or explain segmentation choices in prose.
31
32	The script validates IDs against reference files, runs boolean validation on text fields, and refuses to build invalid URLs.
33
34	## Spec format (complete)
35
36	```json
37	{
38	"filters": [
39	{"type": "INDUSTRY", "values": [{"id": 4, "selectionType": "INCLUDED"}]},
40	{"type": "FUNCTION", "values": [{"id": 15, "selectionType": "INCLUDED"}]},
41	{"type": "REGION", "values": [{"id": 105015875, "selectionType": "INCLUDED"}]},
42	{"type": "CURRENT_TITLE", "values": [{"text": "(CMO OR \"Chief Marketing Officer\") NOT Fractional", "selectionType": "INCLUDED"}]},
43	{"type": "RECENTLY_CHANGED_JOBS", "toggle": true}
44	]
45	}
46	```
47
48	Field rules (complete — do not consult spec-schema.md):
49	- `type` — one of the filter types listed below.
50	- `values` — array of value objects.
51	- `id` — for ID-based filters. Integer for most enums; single-letter string for `COMPANY_HEADCOUNT` and `COMPANY_TYPE`; 2-letter code for `PROFILE_LANGUAGE`.
52	- `text` — for text-only filters (`FIRST_NAME`, `LAST_NAME`, `CURRENT_TITLE`, `PAST_TITLE`, `KEYWORDS`). Auto-resolved for ID-based filters — omit it there.
53	- `selectionType` — `"INCLUDED"` (default) or `"EXCLUDED"`. Use `EXCLUDED` when the user says "exclude", "except", "not", "without".
54	- `toggle: true` — shortcut for toggle filters; the builder auto-fills the hardcoded ID.
55
56	When a user targets multiple values of the same filter type (e.g., "France, Germany, Italy"), put them all in one filter object's `values` array — LinkedIn applies OR within a filter and AND across filters.
57
58	## Region presets (USE THESE for multi-country targeting)
59
60	B2B sellers think in regional groupings, not individual countries

People who liked this also viewed

6 picks

Type