docs: sharpen ApiProber discovery context

Author: Lukas Geiger

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2026-06-06
+
+- Added a README start table and smoke-test badge for clearer GitHub entry.
+- Expanded `llms.txt` with search phrases and disambiguation context.
+- Corrected private vulnerability reporting links after the move to `dev-bricks/apiprober`.
+
 ## 2026-06-01
 
 - Fixed repository metadata after the move to `dev-bricks/apiprober`.

README.md

@@ -4,6 +4,8 @@
 
 # ApiProber -- Passive API Discovery and Documentation Tool
 
+[![ApiProber smoke tests](https://github.com/dev-bricks/apiprober/actions/workflows/tests.yml/badge.svg)](https://github.com/dev-bricks/apiprober/actions/workflows/tests.yml)
+
 ApiProber is a zero-dependency Python CLI for passive API discovery. It helps
 developers and maintainers map undocumented REST services, compare live
 behavior with API documentation, persist observations in SQLite, and export
@@ -13,6 +15,18 @@ Markdown or JSON documentation.
 
 ---
 
+## Start Here
+
+| Goal | Command or File |
+|---|---|
+| Try the CLI | `python api_prober.py --help` |
+| Map an authorized API | `python api_prober.py probe <base-url>` |
+| Export documentation | `python api_prober.py export <service> --format md` |
+| Read machine context | [`llms.txt`](llms.txt) |
+| Report a vulnerability privately | [`SECURITY.md`](SECURITY.md) |
+
+---
+
 ## Best Fit
 
 - Internal REST services where no OpenAPI file exists
@@ -180,7 +194,12 @@ ApiProber/
 
 `passive API discovery`, `REST API documentation generator`, `OpenAPI detection`,
 `HATEOAS link crawler`, `local-first API reconnaissance`, `zero-dependency Python
-CLI`, `SQLite API inventory`, `ethical API probing`
+CLI`, `SQLite API inventory`, `ethical API probing`, `authorized API inventory`,
+`REST endpoint mapper`
+
+ApiProber is unrelated to Cloudprober, probe-rs, code-search probe tools, and
+active uptime monitoring systems. Its focus is local, rate-limited REST API
+surface documentation for systems you own or are explicitly allowed to assess.
 
 ---
 

SECURITY.md

@@ -5,12 +5,12 @@
 If you find a security vulnerability, please report it responsibly:
 
 1. **Do NOT open a public issue**
-2. **Use GitHub's [private vulnerability reporting](https://github.com/lukisch/apiprober/security/advisories/new)**
+2. **Use GitHub's [private vulnerability reporting](https://github.com/dev-bricks/apiprober/security/advisories/new)**
 3. Include: description, steps to reproduce, potential impact
 
 ### How to Report
 
-1. Go to: https://github.com/lukisch/apiprober/security/advisories/new
+1. Go to: https://github.com/dev-bricks/apiprober/security/advisories/new
 2. Fill out the form (title, description, severity, affected versions)
 3. Submit privately (not visible to public until disclosed)
 

llms.txt

@@ -67,4 +67,11 @@ python api_prober.py probe https://jsonplaceholder.typicode.com --depth 0 --dela
 
 passive API discovery, REST API documentation generator, OpenAPI detection,
 HATEOAS link crawler, local-first API reconnaissance, zero-dependency Python CLI,
-SQLite API inventory, ethical API probing
+SQLite API inventory, ethical API probing, authorized API inventory, REST endpoint
+mapper, undocumented REST API documentation, local OpenAPI discovery
+
+## Disambiguation
+
+ApiProber is not Cloudprober, probe-rs, an uptime monitor, a hardware debug
+probe, or a semantic code-search engine. It is a local Python CLI for documenting
+authorized REST API surfaces with read-only probing and SQLite persistence.