Binary instructions in README

Author: jeromechoo

README.md

@@ -5,11 +5,19 @@ Python client library for [Diffbot](https://www.diffbot.com) APIs.
 
 ## Installation
 
+Install the [standalone CLI binary](#standalone-binary) for [agentic use](#how-to-use-with-an-agent):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh
+```
+
+If you prefer, the full Python library can also be installed with pip:
+
 ```bash
 python3 -m pip install diffbot-python
 ```
 
-Or, for local development:
+For local development:
 
 ```bash
 pip install -e ".[dev]"
@@ -202,9 +210,9 @@ uv tool install .
 
 This drops a `db` executable into `~/.local/bin` (ensure it is on your `PATH`). Use `--force` to reinstall or upgrade after changes, or `--editable` to have source edits take effect immediately. Alternatively, a plain `pip install .` (or `pip install -e .`) also installs the `db` entry point into the active environment.
 
-### Standalone binary (no Python required)
+### Standalone binary
 
-Every release also ships a self-contained `db` binary for Linux (x86_64 and aarch64) and macOS (Apple Silicon) — no Python install needed. The installer detects your platform, verifies the SHA256 checksum, and installs (or upgrades) `db` into `~/.local/bin`:
+Every release also ships a self-contained `db` binary for Linux (x86_64 and aarch64) and macOS (Apple Silicon) as a Python-free option. The installer detects your platform, verifies the SHA256 checksum, and installs (or upgrades) `db` into `~/.local/bin`:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh
@@ -216,6 +224,8 @@ Pin a specific release or install location with flags (or the `DB_VERSION` / `DB
 curl -fsSL https://raw.githubusercontent.com/diffbot/diffbot-python/main/install.sh | sh -s -- --version v0.2.1 --bin-dir ~/bin
 ```
 
+### How to use
+
 ```bash
 export DIFFBOT_API_TOKEN=your-token-here
 
@@ -230,6 +240,12 @@ db entities "Apple CEO Tim Cook announced record quarterly earnings."
 db entities "Apple CEO Tim Cook announced record quarterly earnings." -f dql
 ```
 
+### How to use with an agent
+Once installed, this library will work alongside [`diffbot-skills`](https://github.com/diffbot/diffbot-skills) to enable your agent full access to structuring web knowledge with Diffbot. Diffbot Agent Skills even unlocks some additional skills like crafting DQL from natural language. 
+
+`diffbot-skills` will pick up or install this library automatically. 
+
+
 ## Tests
 
 Run the mock test suite: