Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Ashby Location Filter

von rctrutaVersion 0.2.2i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.rctruta/ashby-location-filter

So installierst du es

Was es kann

MCP server for canonical Ashby job board search, location normalization, and scope classification.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 2/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Ashby Location Filter. Folge https://mcp.popnx.com/i/rctruta-ashby-location-filter.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

2/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 20. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Ashby Location Filter für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "ashby-location-filter": { "command": "npx", "args": [ "-y", "ashby-location-filter" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Ashby Location Filter wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  3. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "ashby-location-filter": {
          "command": "npx",
          "args": [
            "-y",
            "ashby-location-filter"
          ]
        }
      }
    }
  4. Claude beenden und neu öffnen

  5. Ausprobieren

    Nutze Ashby Location Filter und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Ashby Location Filter nutzt, oder ein Werkzeug von Ashby Location Filter in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Ashby Location Filter noch nicht verbinden

Ashby Location Filter läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Ashby Location Filter verbinden kann

  • Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Reisen, Karten & Wetter, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Ashby Location Filter für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user ashby-location-filter -- npx -y ashby-location-filter 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Ashby Location Filter wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user ashby-location-filter -- npx -y ashby-location-filter
  4. /mcp in Claude Code eingeben

    Ashby Location Filter sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Ashby Location Filter und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Ashby Location Filter nutzt, oder ein Werkzeug von Ashby Location Filter in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Ashby Location Filter für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "ashby-location-filter": { "command": "npx", "args": [ "-y", "ashby-location-filter" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Ashby Location Filter wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in Cursor im Agent-Modus öffnen

  4. Ausprobieren

    Nutze Ashby Location Filter und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Ashby Location Filter nutzt, oder ein Werkzeug von Ashby Location Filter in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Ashby Location Filter für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "ashby-location-filter": { "type": "stdio", "command": "npx", "args": [ "-y", "ashby-location-filter" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Ashby Location Filter wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. KI-Chat in VS Code im Agent-Modus öffnen

  4. Ausprobieren

    Nutze Ashby Location Filter und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Ashby Location Filter nutzt, oder ein Werkzeug von Ashby Location Filter in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Ashby Location Filter nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user ashby-location-filter -- npx -y ashby-location-filter

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ashby-location-filter": {
      "command": "npx",
      "args": [
        "-y",
        "ashby-location-filter"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ashby-location-filter": {
      "command": "npx",
      "args": [
        "-y",
        "ashby-location-filter"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ashby-location-filter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ashby-location-filter"
      ]
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.2.2
In der Registry veröffentlichti
20. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Entwickler
rctruta
Pakete
npm: ashby-location-filter
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 21. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto rctruta bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vorgestern

  • ! Vorsicht

    Hat eine Lizenz

    GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/rctruta-ashby-location-filter.svg)](https://mcp.popnx.com/en/servers/rctruta-ashby-location-filter)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 0 % der anderen 2083 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 2083 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 58 % der anderen 2083 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Ashby Location Filter sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (0.2.2) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

von microWachsend★ 441Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 16Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 14 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
Ashby Location Filter
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen2/34/43/33/34/44/4
LizenzNOASSERTIONAGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

ashby-location-filter

A multi-company job search and filtering engine tailored for public Ashby job boards. It aggregates job postings from multiple companies into a single cohesive interface, normalizes inconsistent recruiter location entries, tracks daily additions and delistings, and provides real-time multi-faceted filtering.

What Problems This Solves

  1. Multi-Company Aggregation: Search across all your target companies (e.g. Cohere, Ramp, Linear, InfluxData) in one place instead of opening dozens of career tabs.
  2. Normalized City & Country Hierarchy: Recruiter strings like "Toronto" (Cohere) and "Toronto, ON" (Ramp) are automatically merged into a single bucket (Toronto (76)), avoiding fragmented search buckets.
  3. Collision-Proof Location Scoping: Grouped by country (optgroup) and scoped strictly by country code, ensuring London, ON (Canada) never merges with London (UK).
  4. Multi-Select Company & Workplace: Compare any subset of companies (e.g., Ramp + Linear) or view all companies with one click. Filter across Remote, Hybrid, and In-office simultaneously.
  5. Diff Tracking: Highlights new openings added since the last run and marks roles delisted/removed by companies.
  6. Zero-Build Architecture: Modern ES modules and CSS with no Node.js build step or bundler needed. Runs directly in any modern browser.

Getting Started

1. Prerequisites
  • Python 3.10+
  • uv (recommended) or standard Python pip
  • A modern web browser
2. Setup

Clone the repository and install dependencies:

git clone https://github.com/rctruta/ashby-location-filter.git

cd ashby-location-filter

uv sync

Important for contributors: To enable repository quality and security guardrails:

`sh

git config core.hooksPath .githooks

`


Workflow & Usage

1. Validate, Add, or Remove Companies

You can add or remove any company that uses Ashby for its careers page using the built-in CLI:

# Test & validate an Ashby job board without changing configuration

python3 -m tools.add_company notion --dry-run

Automatically validate endpoint, register in config, and fetch snapshot

python3 -m tools.add_company https://jobs.ashbyhq.com/notion --name "Notion"

Remove a company from publish_snapshot.yaml, delete its snapshot, and update manifest.json

python3 -m tools.add_company influxdata --remove

The CLI:

  • Extracts the company slug from a name, slug, or full career URL.
  • Validates the remote Ashby Posting API.
  • Checks isListed job counts.
  • Appends the company configuration to tools/publish_snapshot.yaml.
  • Fetches the snapshot to docs/data/ .json and rebuilds docs/data/manifest.json.
2. Update Job Board Snapshots

Refresh snapshots for all configured companies from live feeds:

python3 tools/publish_snapshot.py --all

Or refresh an individual company or parse from a local test file:

python3 tools/publish_snapshot.py --company ramp

python3 tools/publish_snapshot.py path/to/sample_feed.json

3. Launch the Web Interface Locally

Start a local web server to view and interact with the application:

python3 -m http.server 8080 --directory docs

Then open http://localhost:8080 in your browser.


Integrating the Normalizer in Custom Job Boards

If you are building a custom career site with Ashby's Posting API, you can install and import the canonical normalizer directly (zero runtime dependencies, native Unicode CLDR):

npm install github:rctruta/ashby-location-filter
import { normalizeLocation, classifyScope } from "ashby-location-filter";

const result = normalizeLocation({ rawName: "San Fransisco, CA [Hiring Immediately]", locality: "San Francisco", region: "California", country: "USA" });

console.log(result); // { // canonicalCity: "San Francisco", // canonicalRegion: "California", // canonicalCountry: "United States", // scope: "metro", // isRemote: false, // displayName: "San Francisco, United States", // compoundKey: "p:United States|||San Francisco" // }


MCP Server (Claude Desktop, Cursor, Antigravity)

This repository includes a zero-dependency Model Context Protocol (MCP) server (mcp-name: io.github.rctruta/ashby-location-filter) that exposes canonical Ashby job search, location normalization, and scope classification tools over stdio:

  • normalize_location — Normalize raw ATS location strings + postal addresses using Unicode CLDR (Intl.DisplayNames) and recruiter alias rules.
  • list_companies — List tracked Ashby job boards available in local snapshots.
  • search_jobs — Search and filter jobs across tracked companies (or any live Ashby company slug) by canonical country, city, scope (global, country, region, metro), workplace type, department, or keyword.

Add to your MCP client configuration (e.g. claude_desktop_config.json or .cursor/mcp.json):

{

"mcpServers": { "ashby-location-filter": { "command": "npx", "args": ["-y", "github:rctruta/ashby-location-filter"] } } }


Hosting Your Own Job Board Filter

You can easily fork this repository and host your own custom job board tracker for your personal list of target companies:

Option A: Free Static Hosting (GitHub Pages)
  1. Fork this repository on GitHub.
  2. Customize your company list: Edit tools/publish_snapshot.yaml to include the companies you want to track, then run python3 tools/publish_snapshot.py --all.
  3. Enable GitHub Pages: Go to your repository Settings → Pages → Source: Deploy from branch (`main`, folder `/docs`).
  4. Daily Updates: The included GitHub Actions workflow (.github/workflows/update_snapshots.yml) will automatically run every day at 06:00 UTC, fetch fresh postings, compute diffs, and commit them back to your repo.
Option B: Serverless On-Demand Hosting (Vercel)

If you want an on-demand deployment where visitors can query any company dynamically via an API proxy:

  1. Connect your repository to Vercel: Import your GitHub fork into Vercel.
  2. The included vercel.json and api/jobs.py automatically configure:
  • Serving docs/ as the fast static frontend.
  • An API proxy at /api/jobs?company= that fetches live Ashby feeds and injects CORS headers.
  1. Test locally with the serverless endpoint:
   python3 api/jobs.py

In another terminal:

curl "http://localhost:3000/api/jobs?company=linear"


Automated Daily Sync (GitHub Actions)

The repository includes a GitHub Actions workflow (.github/workflows/update_snapshots.yml):

  • Daily Cron: Runs automatically at 06:00 UTC every day.
  • Manual Trigger: Run on demand via Actions → Update Job Board Snapshots → Run workflow.
  • Automatically commits and pushes updated snapshots back to main, keeping live deployments up-to-date with zero manual intervention.

Configuration (tools/publish_snapshot.yaml)

Companies and fields are configured declaratively:

posting_fields:
  • id
  • title
  • department
  • team
  • location
  • address
  • secondaryLocations
  • workplaceType
  • jobUrl

companies:

  • id: cohere name: Cohere provider: Ashby feed_url: https://api.ashbyhq.com/posting-api/job-board/cohere output: docs/data/cohere.json
  • id: ashby name: Ashby provider: Ashby feed_url: https://api.ashbyhq.com/posting-api/job-board/ashby output: docs/data/ashby.json

manifest_output: docs/data/manifest.json


Repository Guardrails & Integrity

This repository adheres to strict agent and human pair-programming contracts documented in AGENTS.md:

  • pre-commit and pre-push hooks enforce clean trees, conventional commits, secret detection, and test suite passage.
  • Run gate proof suite: sh .gates/tests/prove_gates.sh.
  • Run pytest suite: uv run pytest.
  • Run Node.js normalizer & MCP test suite: npm test.

Future Roadmap

  • UI-Based Company Persistence: Allow users to add, pin, and persist custom Ashby company boards directly from the browser UI alongside daily repository snapshots.
  • Additional ATS Normalizer Adapters: Extend canonical location normalization and scope classification adapters to Greenhouse and Lever feeds.

License

Dual-licensed under the Apache License 2.0 (code and tools) and Creative Commons Attribution 4.0 International (CC BY 4.0) (documentation and published snapshot data).