site-shot 0.1.0__tar.gz

site_shot-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+*.png
+*.jpeg
+.DS_Store

site_shot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Site-Shot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

site_shot-0.1.0/PKG-INFO

@@ -0,0 +1,294 @@
+Metadata-Version: 2.5
+Name: site-shot
+Version: 0.1.0
+Summary: Official Python SDK for the Site-Shot screenshot API — capture website screenshots in a real Chromium browser (full-page, country proxies, ad & cookie-banner removal). Zero dependencies.
+Project-URL: Homepage, https://www.site-shot.com/
+Project-URL: Documentation, https://www.site-shot.com/#documentation
+Project-URL: API keys & pricing, https://www.site-shot.com/pricing/
+Project-URL: For AI agents, https://www.site-shot.com/ai-agents/
+Project-URL: Repository, https://github.com/site-shot/site-shot-python
+Project-URL: Issues, https://github.com/site-shot/site-shot-python/issues
+Author-email: Site-Shot <support@site-shot.com>
+Maintainer-email: Site-Shot <support@site-shot.com>
+License: MIT
+License-File: LICENSE
+Keywords: api-client,full-page-screenshot,screenshot,screenshot-api,sdk,site-shot,url-to-image,web-capture,web-scraping,website-screenshot
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# site-shot
+
+Official Python SDK for the [Site-Shot](https://www.site-shot.com/) screenshot API.
+
+```bash
+pip install site-shot
+```
+
+Capture website screenshots in a real Chromium browser: full-page capture, country
+proxies, automatic ad & cookie-banner removal. **Zero dependencies** (standard
+library only), Python >= 3.9, fully typed (`py.typed`), sync.
+
+API plans from **$5/mo** (X-Lite, 2,000 screenshots). The
+[free browser tool](https://www.site-shot.com/) is no-signup, but the **API
+requires a key** — get one at <https://www.site-shot.com/pricing/>.
+
+## Quickstart
+
+```python
+from site_shot import SiteShot
+
+client = SiteShot("YOUR_API_KEY")  # or set SITESHOT_API_KEY in the env
+
+png = client.capture("example.com", full_size=True)  # png is bytes
+with open("shot.png", "wb") as f:
+    f.write(png)
+```
+
+The import package is `site_shot`; the pip name is `site-shot` (PyPI treats the
+two spellings as the same project).
+
+Building an AI agent with an MCP-capable client instead? Use the sibling MCP
+server: `npx -y site-shot-mcp`. Working in Node? `npm install site-shot-sdk`.
+
+## Capture cleanly (ads and cookie banners removed)
+
+```python
+png = client.capture(
+    "https://example.com/",
+    no_ads=True,
+    no_cookie_popup=True,
+)
+```
+
+## Return modes
+
+One capture concept, four return modes — pick the method, not a flag:
+
+```python
+# 1. Bytes (primary mode)
+png = client.capture("https://example.com/")
+
+# 2. Straight to a file
+client.capture_to_file("https://example.com/", "shot.png")
+
+# 3. Base64 string (data URLs, LLM vision payloads)
+b64 = client.capture_base64("https://example.com/")
+
+# 4. Full JSON result (image plus metadata; add source_code for rendered HTML)
+meta = client.capture_json("https://example.com/", source_code=True)
+print(meta["source_code"][:200])
+```
+
+`url` is positional-only, every capture option is a keyword argument. An options
+dict works too: `client.capture(url, **options)`.
+
+### `build_url()` — build the request URL without executing it
+
+```python
+url = client.build_url("https://example.com/", width=1280)
+```
+
+> **⚠️ Key-leak warning:** the returned URL **embeds your API key** (`userkey`),
+> and Site-Shot has no signed-URL scheme. Use it for debugging or server-side
+> proxying only. **Never** put it in an `<img src>` or anywhere a browser or
+> third party can see it.
+
+## Screenshots from another country
+
+Pass `country` as an **ISO 3166-1 alpha-2 code** (e.g. `"DE"`, `"BR"`, `"JP"` —
+the current list is at <https://www.site-shot.com/countries/>). It automatically
+sets a matching IP, language, time zone, and geolocation. Full country names are
+not valid values.
+
+By default, if the requested country has no capacity at that moment, the API
+silently falls back to a US vantage point. Set `strict_country` to fail fast
+instead:
+
+```python
+from site_shot import SiteShot, CountryUnavailableError
+
+client = SiteShot("YOUR_API_KEY", retries=2)  # recommended for geo captures
+
+try:
+    shot = client.capture(
+        "https://whatismycountry.com/",
+        country="DE",          # ISO 3166-1 alpha-2, never "Germany"
+        strict_country=True,
+        no_ads=True,
+        no_cookie_popup=True,
+    )
+except CountryUnavailableError:
+    ...  # No live DE capacity right now — retry later or drop strict_country.
+```
+
+A GPS override, independent of the exit IP:
+
+```python
+png = client.capture(
+    "https://whatismycountry.com/",
+    country="JP",              # ISO code
+    geolocation="35.6762,139.6503",
+    time_zone="Asia/Tokyo",
+    language="ja",
+)
+```
+
+More on geotargeted screenshots:
+<https://www.site-shot.com/blog/screenshot-website-from-another-country/>
+
+## Options
+
+Option names mirror the HTTP query parameters **verbatim** (snake_case) — the
+[API reference on the homepage](https://www.site-shot.com/#documentation) and
+this SDK share one vocabulary. Booleans are accepted and coerced to `1`/`0`.
+**Unknown options pass through verbatim**, so future API params work without an
+SDK update.
+
+| Option | Type / range | API default | Notes |
+|---|---|---|---|
+| `url` | str, **required** (positional-only) | — | bare domains like `example.com` accepted (`https://` assumed) |
+| `width` | int 100–8000 | 1024 | viewport width |
+| `height` | int 100–20000 | 768 | viewport height |
+| `zoom` | int 5–1000 | 100 | percentage zoom |
+| `full_size` | bool | False | full-page capture (height capped by `max_height`) |
+| `max_height` | int 100–20000 | 15000 | only meaningful with `full_size` |
+| `scaled_width` | int 50–10000 | — | scale result image to width |
+| `format` | `"png"` \| `"jpeg"` | png | |
+| `delay_time` | int ms 0–60000 | 1500 | wait before capture (SPAs, animations) |
+| `timeout` | int ms 0–120000 | 60000 | server-side render deadline |
+| `user_agent` | str | — | custom UA for the rendering browser |
+| `request_headers` | dict | — | emitted as repeated `request_header=Name:value` params |
+| `http_proxy` / `proxy_username` / `proxy_password` | str | — | bring-your-own-proxy passthrough |
+| `proxy_rotation` | bool | True | |
+| `source_code` | bool | False | include rendered HTML (use with `capture_json`) |
+| `javascript_code` | str | — | inject JS into the page before capture |
+| `no_ads` | bool | False | remove ads |
+| `no_cookie_popup` | bool | False | remove cookie-consent banners |
+| `country` | ISO 3166-1 alpha-2 | — | e.g. `"DE"` — auto-sets language/time zone/geolocation |
+| `strict_country` | bool | False | fail fast instead of silent US fallback |
+| `geolocation` | `"lat,lng"` | — | GPS override, independent of IP |
+| `language` | str | from `country` / en | Accept-Language |
+| `time_zone` | IANA name | America/New_York | see <https://www.site-shot.com/time-zones/> |
+
+`userkey` (your API key) is owned by the `SiteShot` constructor — never a
+per-call option. `response_type` is owned by the return-mode methods.
+
+A `CaptureOptions` `TypedDict` is exported for callers who build option dicts:
+
+```python
+from site_shot import CaptureOptions
+
+options: CaptureOptions = {"width": 1280, "full_size": True, "country": "DE"}
+png = client.capture("https://example.com/", **options)
+```
+
+`url` is positional-only on every capture method, so an options dict that also
+carries a `url` key still type-checks and runs — the positional URL wins, just
+like `userkey`. (These snippets are type-checked under `mypy --strict` in the
+test suite.)
+
+The SDK sends GET requests; very long `javascript_code` or `user_agent` values
+can exceed practical URL length limits (~8 KB).
+
+## Client options
+
+```python
+client = SiteShot(
+    "YOUR_API_KEY",
+    base_url="https://api.site-shot.com/",
+    timeout=90,   # client-side deadline in SECONDS; default = server `timeout` + 30s headroom
+    retries=0,    # connection-level retries only (see below)
+)
+```
+
+The API key falls back to the `SITESHOT_API_KEY` environment variable — the same
+variable the [Site-Shot MCP server](https://www.npmjs.com/package/site-shot-mcp)
+uses:
+
+```python
+import os
+client = SiteShot()                                 # reads SITESHOT_API_KEY
+client = SiteShot(os.environ["SITESHOT_API_KEY"])    # or pass it explicitly
+```
+
+Two different things are called "timeout", exactly as in the HTTP API:
+
+- the constructor's `timeout` is the **client-side deadline in seconds**, and it
+  bounds the *whole* exchange — connecting, waiting for the status line and
+  headers, and downloading the image body (a slow drip in any of those phases
+  cannot outlast it);
+- the capture option `timeout` is the **server-side render deadline in
+  milliseconds** (the verbatim HTTP param name).
+
+`SiteShot` also works as a context manager (`with SiteShot(...) as client:`); it
+holds no pooled resources, so closing it is a no-op.
+
+## Errors
+
+Every error is a subclass of `SiteShotError` and carries `http_status` and the
+raw response `body` where available.
+
+| Error | Raised when |
+|---|---|
+| `AuthError` | missing or rejected API key (also raised by the constructor on an empty key) |
+| `QuotaError` | plan quota exhausted / payment required |
+| `CountryUnavailableError` | `strict_country` capture and the requested country has no capacity right now |
+| `InvalidParamsError` | the API rejected a parameter (out-of-range width, bad format, ...) |
+| `SiteShotTimeoutError` | client-side deadline, or the API reported a render timeout |
+| `APIError` | anything else (server errors, unparseable bodies, connection failures) |
+
+```python
+from site_shot import SiteShot, SiteShotError, QuotaError
+
+try:
+    png = client.capture("https://example.com/")
+except QuotaError as e:
+    print("out of quota:", e, e.http_status)
+except SiteShotError as e:
+    print("capture failed:", e)
+```
+
+Under the hood the SDK always asks the API for a JSON response and decodes the
+image itself — so errors surface as typed exceptions instead of an error picture
+pretending to be your screenshot.
+
+## Retries
+
+Default: `0`. Screenshots cost quota, and a timed-out render may still have
+consumed one — so the SDK never auto-retries a render that completed with an
+error. The `retries` option applies to **connection-level failures only** (DNS,
+connection reset, no bytes received), with jittered backoff. `retries=2` is a
+sensible setting for `country=` captures.
+
+## Requirements
+
+- Python >= 3.9
+- Zero dependencies (standard library `urllib` only)
+
+## Links
+
+- Pricing & API keys: <https://www.site-shot.com/pricing/>
+- For AI agents & assistants: <https://www.site-shot.com/ai-agents/>
+- Supported countries: <https://www.site-shot.com/countries/>
+- Time zones: <https://www.site-shot.com/time-zones/>
+- Node.js SDK: `npm install site-shot-sdk`
+- MCP server (agent tooling sibling): `npx -y site-shot-mcp`
+
+## License
+
+MIT

site_shot-0.1.0/README.md

@@ -0,0 +1,261 @@
+# site-shot
+
+Official Python SDK for the [Site-Shot](https://www.site-shot.com/) screenshot API.
+
+```bash
+pip install site-shot
+```
+
+Capture website screenshots in a real Chromium browser: full-page capture, country
+proxies, automatic ad & cookie-banner removal. **Zero dependencies** (standard
+library only), Python >= 3.9, fully typed (`py.typed`), sync.
+
+API plans from **$5/mo** (X-Lite, 2,000 screenshots). The
+[free browser tool](https://www.site-shot.com/) is no-signup, but the **API
+requires a key** — get one at <https://www.site-shot.com/pricing/>.
+
+## Quickstart
+
+```python
+from site_shot import SiteShot
+
+client = SiteShot("YOUR_API_KEY")  # or set SITESHOT_API_KEY in the env
+
+png = client.capture("example.com", full_size=True)  # png is bytes
+with open("shot.png", "wb") as f:
+    f.write(png)
+```
+
+The import package is `site_shot`; the pip name is `site-shot` (PyPI treats the
+two spellings as the same project).
+
+Building an AI agent with an MCP-capable client instead? Use the sibling MCP
+server: `npx -y site-shot-mcp`. Working in Node? `npm install site-shot-sdk`.
+
+## Capture cleanly (ads and cookie banners removed)
+
+```python
+png = client.capture(
+    "https://example.com/",
+    no_ads=True,
+    no_cookie_popup=True,
+)
+```
+
+## Return modes
+
+One capture concept, four return modes — pick the method, not a flag:
+
+```python
+# 1. Bytes (primary mode)
+png = client.capture("https://example.com/")
+
+# 2. Straight to a file
+client.capture_to_file("https://example.com/", "shot.png")
+
+# 3. Base64 string (data URLs, LLM vision payloads)
+b64 = client.capture_base64("https://example.com/")
+
+# 4. Full JSON result (image plus metadata; add source_code for rendered HTML)
+meta = client.capture_json("https://example.com/", source_code=True)
+print(meta["source_code"][:200])
+```
+
+`url` is positional-only, every capture option is a keyword argument. An options
+dict works too: `client.capture(url, **options)`.
+
+### `build_url()` — build the request URL without executing it
+
+```python
+url = client.build_url("https://example.com/", width=1280)
+```
+
+> **⚠️ Key-leak warning:** the returned URL **embeds your API key** (`userkey`),
+> and Site-Shot has no signed-URL scheme. Use it for debugging or server-side
+> proxying only. **Never** put it in an `<img src>` or anywhere a browser or
+> third party can see it.
+
+## Screenshots from another country
+
+Pass `country` as an **ISO 3166-1 alpha-2 code** (e.g. `"DE"`, `"BR"`, `"JP"` —
+the current list is at <https://www.site-shot.com/countries/>). It automatically
+sets a matching IP, language, time zone, and geolocation. Full country names are
+not valid values.
+
+By default, if the requested country has no capacity at that moment, the API
+silently falls back to a US vantage point. Set `strict_country` to fail fast
+instead:
+
+```python
+from site_shot import SiteShot, CountryUnavailableError
+
+client = SiteShot("YOUR_API_KEY", retries=2)  # recommended for geo captures
+
+try:
+    shot = client.capture(
+        "https://whatismycountry.com/",
+        country="DE",          # ISO 3166-1 alpha-2, never "Germany"
+        strict_country=True,
+        no_ads=True,
+        no_cookie_popup=True,
+    )
+except CountryUnavailableError:
+    ...  # No live DE capacity right now — retry later or drop strict_country.
+```
+
+A GPS override, independent of the exit IP:
+
+```python
+png = client.capture(
+    "https://whatismycountry.com/",
+    country="JP",              # ISO code
+    geolocation="35.6762,139.6503",
+    time_zone="Asia/Tokyo",
+    language="ja",
+)
+```
+
+More on geotargeted screenshots:
+<https://www.site-shot.com/blog/screenshot-website-from-another-country/>
+
+## Options
+
+Option names mirror the HTTP query parameters **verbatim** (snake_case) — the
+[API reference on the homepage](https://www.site-shot.com/#documentation) and
+this SDK share one vocabulary. Booleans are accepted and coerced to `1`/`0`.
+**Unknown options pass through verbatim**, so future API params work without an
+SDK update.
+
+| Option | Type / range | API default | Notes |
+|---|---|---|---|
+| `url` | str, **required** (positional-only) | — | bare domains like `example.com` accepted (`https://` assumed) |
+| `width` | int 100–8000 | 1024 | viewport width |
+| `height` | int 100–20000 | 768 | viewport height |
+| `zoom` | int 5–1000 | 100 | percentage zoom |
+| `full_size` | bool | False | full-page capture (height capped by `max_height`) |
+| `max_height` | int 100–20000 | 15000 | only meaningful with `full_size` |
+| `scaled_width` | int 50–10000 | — | scale result image to width |
+| `format` | `"png"` \| `"jpeg"` | png | |
+| `delay_time` | int ms 0–60000 | 1500 | wait before capture (SPAs, animations) |
+| `timeout` | int ms 0–120000 | 60000 | server-side render deadline |
+| `user_agent` | str | — | custom UA for the rendering browser |
+| `request_headers` | dict | — | emitted as repeated `request_header=Name:value` params |
+| `http_proxy` / `proxy_username` / `proxy_password` | str | — | bring-your-own-proxy passthrough |
+| `proxy_rotation` | bool | True | |
+| `source_code` | bool | False | include rendered HTML (use with `capture_json`) |
+| `javascript_code` | str | — | inject JS into the page before capture |
+| `no_ads` | bool | False | remove ads |
+| `no_cookie_popup` | bool | False | remove cookie-consent banners |
+| `country` | ISO 3166-1 alpha-2 | — | e.g. `"DE"` — auto-sets language/time zone/geolocation |
+| `strict_country` | bool | False | fail fast instead of silent US fallback |
+| `geolocation` | `"lat,lng"` | — | GPS override, independent of IP |
+| `language` | str | from `country` / en | Accept-Language |
+| `time_zone` | IANA name | America/New_York | see <https://www.site-shot.com/time-zones/> |
+
+`userkey` (your API key) is owned by the `SiteShot` constructor — never a
+per-call option. `response_type` is owned by the return-mode methods.
+
+A `CaptureOptions` `TypedDict` is exported for callers who build option dicts:
+
+```python
+from site_shot import CaptureOptions
+
+options: CaptureOptions = {"width": 1280, "full_size": True, "country": "DE"}
+png = client.capture("https://example.com/", **options)
+```
+
+`url` is positional-only on every capture method, so an options dict that also
+carries a `url` key still type-checks and runs — the positional URL wins, just
+like `userkey`. (These snippets are type-checked under `mypy --strict` in the
+test suite.)
+
+The SDK sends GET requests; very long `javascript_code` or `user_agent` values
+can exceed practical URL length limits (~8 KB).
+
+## Client options
+
+```python
+client = SiteShot(
+    "YOUR_API_KEY",
+    base_url="https://api.site-shot.com/",
+    timeout=90,   # client-side deadline in SECONDS; default = server `timeout` + 30s headroom
+    retries=0,    # connection-level retries only (see below)
+)
+```
+
+The API key falls back to the `SITESHOT_API_KEY` environment variable — the same
+variable the [Site-Shot MCP server](https://www.npmjs.com/package/site-shot-mcp)
+uses:
+
+```python
+import os
+client = SiteShot()                                 # reads SITESHOT_API_KEY
+client = SiteShot(os.environ["SITESHOT_API_KEY"])    # or pass it explicitly
+```
+
+Two different things are called "timeout", exactly as in the HTTP API:
+
+- the constructor's `timeout` is the **client-side deadline in seconds**, and it
+  bounds the *whole* exchange — connecting, waiting for the status line and
+  headers, and downloading the image body (a slow drip in any of those phases
+  cannot outlast it);
+- the capture option `timeout` is the **server-side render deadline in
+  milliseconds** (the verbatim HTTP param name).
+
+`SiteShot` also works as a context manager (`with SiteShot(...) as client:`); it
+holds no pooled resources, so closing it is a no-op.
+
+## Errors
+
+Every error is a subclass of `SiteShotError` and carries `http_status` and the
+raw response `body` where available.
+
+| Error | Raised when |
+|---|---|
+| `AuthError` | missing or rejected API key (also raised by the constructor on an empty key) |
+| `QuotaError` | plan quota exhausted / payment required |
+| `CountryUnavailableError` | `strict_country` capture and the requested country has no capacity right now |
+| `InvalidParamsError` | the API rejected a parameter (out-of-range width, bad format, ...) |
+| `SiteShotTimeoutError` | client-side deadline, or the API reported a render timeout |
+| `APIError` | anything else (server errors, unparseable bodies, connection failures) |
+
+```python
+from site_shot import SiteShot, SiteShotError, QuotaError
+
+try:
+    png = client.capture("https://example.com/")
+except QuotaError as e:
+    print("out of quota:", e, e.http_status)
+except SiteShotError as e:
+    print("capture failed:", e)
+```
+
+Under the hood the SDK always asks the API for a JSON response and decodes the
+image itself — so errors surface as typed exceptions instead of an error picture
+pretending to be your screenshot.
+
+## Retries
+
+Default: `0`. Screenshots cost quota, and a timed-out render may still have
+consumed one — so the SDK never auto-retries a render that completed with an
+error. The `retries` option applies to **connection-level failures only** (DNS,
+connection reset, no bytes received), with jittered backoff. `retries=2` is a
+sensible setting for `country=` captures.
+
+## Requirements
+
+- Python >= 3.9
+- Zero dependencies (standard library `urllib` only)
+
+## Links
+
+- Pricing & API keys: <https://www.site-shot.com/pricing/>
+- For AI agents & assistants: <https://www.site-shot.com/ai-agents/>
+- Supported countries: <https://www.site-shot.com/countries/>
+- Time zones: <https://www.site-shot.com/time-zones/>
+- Node.js SDK: `npm install site-shot-sdk`
+- MCP server (agent tooling sibling): `npx -y site-shot-mcp`
+
+## License
+
+MIT

site_shot-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "site-shot"
+version = "0.1.0"
+description = "Official Python SDK for the Site-Shot screenshot API — capture website screenshots in a real Chromium browser (full-page, country proxies, ad & cookie-banner removal). Zero dependencies."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Site-Shot", email = "support@site-shot.com" }]
+maintainers = [{ name = "Site-Shot", email = "support@site-shot.com" }]
+keywords = [
+    "screenshot",
+    "screenshot-api",
+    "website-screenshot",
+    "site-shot",
+    "sdk",
+    "api-client",
+    "full-page-screenshot",
+    "url-to-image",
+    "web-capture",
+    "web-scraping",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Multimedia :: Graphics :: Capture :: Screen Capture",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://www.site-shot.com/"
+Documentation = "https://www.site-shot.com/#documentation"
+"API keys & pricing" = "https://www.site-shot.com/pricing/"
+"For AI agents" = "https://www.site-shot.com/ai-agents/"
+Repository = "https://github.com/site-shot/site-shot-python"
+Issues = "https://github.com/site-shot/site-shot-python/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/site_shot"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/scripts",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.mypy]
+strict = true
+# Always check the checked-out source, never a stale installed copy.
+mypy_path = "src"
+# The tests are checked too: consumer-shaped usage is exactly where the exported
+# TypedDict broke, and checking only src/ is why that shipped. Bodies are
+# checked everywhere; only the legacy test module is excused from annotating
+# every def.
+files = ["src/site_shot", "tests"]
+
+[[tool.mypy.overrides]]
+module = ["test_client", "tests.test_client"]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+disallow_untyped_calls = false
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"