diff --git a/docs/browser-use-debugging.html b/docs/browser-use-debugging.html
index 480e04c0..2111760b 100644
--- a/docs/browser-use-debugging.html
+++ b/docs/browser-use-debugging.html
@@ -421,6 +421,8 @@ <h2 id="compare-run-metadata-checklist">Compare failed and successful Browser Us
       <pre><code>browsertrace list
 browsertrace compare &lt;failed_run_id&gt; &lt;success_run_id&gt;
 browsertrace compare &lt;failed_run_id&gt; &lt;success_run_id&gt; --json</code></pre>
+      <p>While the local BrowserTrace UI is running, local wrappers and tools can request the same first-divergence payload through the web API:</p>
+      <pre><code>curl http://127.0.0.1:3000/api/compare/&lt;failed_run_id&gt;/&lt;success_run_id&gt;</code></pre>
       <p>Example compare output:</p>
       <pre><code>$ browsertrace compare failed-local-html-upload good-local-html-upload
 First divergent step: 3
diff --git a/tests/test_metadata.py b/tests/test_metadata.py
index a9c92da0..7cb06814 100644
--- a/tests/test_metadata.py
+++ b/tests/test_metadata.py
@@ -3995,6 +3995,12 @@ def test_browser_use_guide_documents_compare_run_metadata_checklist():
         1,
     )[0]
     assert "browsertrace compare &lt;failed_run_id&gt; &lt;success_run_id&gt;" in section
+    assert (
+        "curl http://127.0.0.1:3000/api/compare/&lt;failed_run_id&gt;/&lt;success_run_id&gt;"
+        in section
+    )
+    assert "local BrowserTrace UI is running" in section
+    assert "same first-divergence payload" in section
     assert "first divergent step" in section
     assert "Example compare output:" in section
     assert "$ browsertrace compare failed-local-html-upload good-local-html-upload" in section