Structured visual analysis pipeline for coding agents - give your AI agent the ability to see
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"page-vision-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Page Vision MCP > Structured visual analysis pipeline for coding agents — give your AI agent the ability to **see**. [](https://pypi.org/project/page-vision-mcp/) [](https://pypi.org/project/page-vision-mcp/) [](https://opensource.org/licenses/MIT) ## What It Does Page Vision MCP turns visual analysis from a prompt into a **tool**. Instead of asking an LLM to "look at this image," your coding agent calls a structured API that returns consistent, machine-readable results with coordinates. **5 Tools:** | Tool | What It Does | VLM | Playwright | |------|-------------|:---:|:----------:| | `capture_page` | Screenshot a webpage (fallback) | - | Yes | | `analyze_ui` | Structured UI analysis with region-level localization | Yes | - | | `compare_ui` | Screenshot diff with mode constraints | Yes | - | | `extract_text` | Block-level OCR with coordinates | Yes | - | | `crop_analyze` | Progressive crop refinement with depth guards | Yes | - | **3 Resources:** `vision://health` | `vision://version` | `vision://models` ## Pipeline ``` Screenshot ──> analyze_ui ──> Structured JSON │ ├── Need detail? ──> crop_analyze (depth +1) ├── Need text? ──> extract_text └── Need diff? ──> compare_ui ``` ## Quick Start ### Install ```bash pip install page-vision-mcp # Optional: Playwright for screenshot fallback pip install "page-vision-mcp[playwright]" playwright install chromium ``` ### Configure Set environment variables (or create a `.env` file, see `.env.example`): ```bash VISION_API_KEY=your-api-key VISION_BASE_URL=https://api.openai.com/v1 VISION_MODEL_ID=gpt-4o ``` Works with any OpenAI-compatible VLM: GPT-4o, GLM-4V, Qwen-VL, etc. ### MCP Cl…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.