docs: lead README with Context.dev capabilities

Author: YahiaBakour

README.md

@@ -3,9 +3,7 @@
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/context.dev.svg?label=pypi%20(stable))](https://pypi.org/project/context.dev/)
 
-The Context Dev Python library provides convenient access to the Context Dev REST API from any Python 3.9+
-application. The library includes type definitions for all request params and response fields,
-and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
+Context.dev is a web scraping API for AI agents and LLMs. This SDK turns any URL into clean, LLM-ready markdown, crawls whole sites, searches the web, takes screenshots and extracts structured JSON against a schema you define, all with one API key. Proxies, JavaScript rendering and anti-bot handling run on Context.dev's side, so there is no headless browser to host.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
@@ -39,6 +37,49 @@ brand = client.brand.retrieve(
 print(brand.request_id)
 ```
 
+### Extract structured JSON
+
+```python
+from context.dev import ContextDev
+
+client = ContextDev()
+
+page = client.web.scrape(
+    url="https://example.com",
+    formats={"json": True},
+    json_params={
+        "schema": {
+            "type": "object",
+            "properties": {
+                "title": {"type": ["string", "null"]},
+                "description": {"type": ["string", "null"]},
+            },
+            "required": ["title", "description"],
+            "additionalProperties": False,
+        },
+    },
+)
+print(page.json_.data)
+```
+
+## What you can do
+
+| Task | Method |
+| --- | --- |
+| Scrape a URL to markdown, HTML, JSON or a screenshot | `client.web.scrape` |
+| Crawl a site and get every page as markdown | `client.web.web_crawl_md` |
+| Map every URL on a domain | `client.web.map_urls` |
+| Search the web | `client.web.search` |
+| Take a screenshot of a page | `client.web.screenshot` |
+| Parse PDFs and documents | `client.parse.handle` |
+| Run thousands of URLs as a batch | `client.batch.submit` |
+| Watch a page for changes | `client.monitors.create` |
+| Look up a company's logo, colors and brand data | `client.brand.retrieve` |
+
+## Use it from an AI agent
+
+Context.dev also ships as a plugin for [Claude](https://github.com/context-dot-dev/claude-plugin), [Cursor](https://github.com/context-dot-dev/cursor-plugin) and [Gemini CLI](https://github.com/context-dot-dev/gemini-cli-context), and as tools for [LangChain](https://github.com/context-dot-dev/langchain-context) and [Haystack](https://github.com/context-dot-dev/context-haystack).
+
 While you can provide an `api_key` keyword argument,
 we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
 to add `CONTEXT_DEV_API_KEY="My API Key"` to your `.env` file