- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add oaustegard/claude-skills --skill capturing-browser-logs -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add oaustegard/claude-skills --skill capturing-browser-logs -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add oaustegard/claude-skills --skill capturing-browser-logs -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add oaustegard/claude-skills --skill capturing-browser-logs -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/oaustegard/claude-skills/tree/HEAD/capturing-browser-logs来自发布者
The user runs the page; you read what it did. Agent Log records the page's console output, uncaught errors, unhandled rejections, failed resource loads, CSP violations and fetch/XHR calls into the browser's IndexedDB, shows a red Logging badge while it records, and exports an OTLP/JSON file the user hands back to you. Nothing is uploaded.
Docs, bookmarklet and console snippet: https://austegard.com/web-utilities/agent-log.html
Use it when the bug happens in a real browser that you do not control: the user's phone, a GPU-specific failure, a page behind their login, timing that a headless run does not reproduce. If you can run the page yourself in Playwright or a browser tool, do that instead and read the console directly. Agent Log does not see iframes, web workers or service workers, and it does not record request or response bodies.
Pick how the user turns it on. Give them exactly one route:
<script src="https://austegard.com/web-utilities/agent-log.js"></script> to its <head>, ship it, and ask the user to open the page with ?logging=true (or &logging=true when the URL already has a query). Logging stays on in that tab across reloads until they press Stop logging. For a page that should always log, use <script src="…" data-start></script>.raw.githubusercontent.com cannot serve the script to a <script> tag (it sends text/plain with nosniff). Use the austegard.com URL, or jsDelivr: https://cdn.jsdelivr.net/gh/oaustegard/oaustegard.github.io@main/web-utilities/agent-log.js.Instrument with structured console calls where the existing output will not answer your question. Pass an object: its keys become OTLP attributes you can filter on.
console.log("bot tick", { tic, pos: { x, y }, sector, target: t?.kind, action });
console.warn("asset retry", { url, attempt, status });
--grep and the body find it.Watch the elements involved when the bug is about an interaction (a button that does nothing, a field that loses its value, a counter that stops updating). Watched elements get records for clicks, typing (one per pause, with the value; password, email, phone and other personal or credential fields are [hidden]), changes, submits, focus, non-text keys, and changes to their attributes, text and children. Pick one of:
&watch=<url-encoded selector> (repeatable) on a page that includes the script, or to run AgentLog.watch("#checkout", { label: "checkout button" }) in the console.AgentLog.unwatch(selector).Ask the user to reproduce, then export. Tell them: click the Logging badge, press Download (or Copy and paste the JSON), and attach the file. The export holds every page load on that site since the log was last cleared; ask them to press Clear before reproducing when old runs would get in the way. Tell them, in one sentence, that the log has stayed in their browser until now and that sending it to you sends it to your provider, so they should look it over and cut anything private before attaching it.
Read the export with the reader below. Save it as read_agent_log.py and run it with the export's path.
python3 read_agent_log.py agent-log.json --pages # page loads: url, start, records, errors
python3 read_agent_log.py agent-log.json --min warn # warnings and errors first
python3 read_agent_log.py agent-log.json --event console --grep "bot tick" --tail 50
python3 read_agent_log.py agent-log.json --event http --attr http.response.status_code=404
python3 read_agent_log.py agent-log.json --event dom --attr watch.label="checkout button" # one watched element
python3 read_agent_log.py agent-log.json --load 2 --jsonl > load2.jsonl # flat rows for pandas or jq
Read errors before anything else, then the records just before the first error in the same page load. Times are UTC.
Verify the capture before diagnosing. --pages must list the page load the user reproduced in, with a URL and a record count above one. If it does not, see the failure modes, fix the capture and ask for another run, rather than reasoning from an empty log.
Report from the records. Quote the timestamp, eventName and attributes you are relying on, so the user can find the same lines in the panel.
#!/usr/bin/env python3
"""Flatten an Agent Log export (OTLP/JSON logs) into one line per record, with filters."""
import argparse, json, sys
from datetime import datetime, timezone
SEV = {"trace": 1, "debug": 5, "info": 9, "warn": 13, "error": 17, "fatal": 21}
def value(v):
if not v: return None
if "stringValue" in v: return v["stringValue"]
if "intValue" in v: return int(v["intValue"])
if "doubleValue" in v: return v["doubleValue"]
if "boolValue" in v: return v["boolValue"]
if "arrayValue" in v: return [value(x) for x in v["arrayValue"].get("values", [])]
if "kvlistValue" in v: return attrs(v["kvlistValue"].get("values"))
return v.get("bytesValue")
def attrs(lst): return {a["key"]: value(a.get("value")) for a in lst or []}
def loads(doc):
for n, rl in enumerate(doc.get("resourceLogs", [])):
res = attrs(rl.get("resource", {}).get("attributes"))
recs = []
for sl in rl.get("scopeLogs", []):
for r in sl.get("logRecords", []):
ns = int(r.get("timeUnixNano") or 0)
recs.append({"load": n, "time": datetime.fromtimestamp(ns / 1e9, timezone.utc).isoformat(timespec="milliseconds"),
"sev": r.get("severityText", ""), "sevn": r.get("severityNumber", 0), "event": r.get("eventName", ""),
"body": value(r.get("body")), "attrs": attrs(r.get("attributes"))})
yield n, res, sorted(recs, key=lambda x: x["time"])
def main():
ap = argparse.ArgumentParser(description=__doc__)
ap.add_argument("file", nargs="?", default="-", help="the export; - reads stdin")
ap.add_argument("--pages", action="store_true", help="list the page loads and stop")
ap.add_argument("--min", choices=list(SEV), help="minimum severity")
ap.add_argument("--event", action="append", default=[], help="eventName prefix, e.g. console, http.fetch, error (repeatable)")
ap.add_argument("--grep", help="case-insensitive text in the body or attributes")
ap.add_argument("--attr", action="append", default=[], help="key=value, compared as text (repeatable)")
ap.add_argument("--load", type=int, help="only this page load, numbered as --pages shows")
ap.add_argument("--tail", type=int, help="only the last N matching records")
ap.add_argument("--jsonl", action="store_true", help="one JSON object per record")
a = ap.parse_args()
doc = json.load(sys.stdin if a.file == "-" else open(a.file, encoding="utf-8"))
if a.pages:
for n, res, recs in loads(doc):
errs = sum(r["sevn"] >= 17 for r in recs)
print(f"[{n}] {res.get('agentlog.started_at', '?')} {len(recs)} records, {errs} errors {res.get('url.full', '?')} ({res.get('user_agent.original', '')[:60]})")
return
out = []
for n, res, recs in loads(doc):
if a.load is not None and n != a.load: continue
for r in recs:
if a.min and r["sevn"] < SEV[a.min]: continue
if a.event and not any(r["event"].startswith(e) for e in a.event): continue
text = f"{r['body']} {json.dumps(r['attrs'], default=str)}"
if a.grep and a.grep.lower() not in text.lower(): continue
if any(str(r["attrs"].get(k)) != v for k, v in (x.split("=", 1) for x in a.attr)): continue
out.append(r)
for r in out[-a.tail:] if a.tail else out:
if a.jsonl: print(json.dumps({k: v for k, v in r.items() if k != "sevn"}, default=str))
else: print(f"[{r['load']}] {r['time'][11:23]} {r['sev']:5} {r['event']:16} {r['body']}" + (f" {json.dumps(r['attrs'], default=str)}" if r["attrs"] else ""))
if __name__ == "__main__":
main()
Without Python, jq reads the same file: jq -c '.resourceLogs[].scopeLogs[].logRecords[] | select(.severityNumber >= 13) | [.eventName, .body.stringValue]' agent-log.json.
An OTLP/JSON ExportLogsServiceRequest. Each page load is one resourceLogs entry; its resource attributes are service.name (the host), session.id, url.full, page.title, user_agent.original, browser.language, browser.viewport, agentlog.started_by and agentlog.started_at. Each log record has timeUnixNano (a string of nanoseconds), severityNumber, severityText, eventName, body.stringValue and attributes, where integers are strings in intValue.
logging=true.agentlog.before_start). An app that kept its own reference to console.log at startup also bypasses the capture when it starts late. Use a page that includes the script and reload it with ?logging=true.AgentLog.start({ max: 100000 }).auth_token or x-api-key, the same pairs in #fragments, and fragments that are one long token), and password, email, phone and other personal fields are [hidden] in watched-element records. Console arguments, the text of watched elements and ordinary field values are recorded as given. Do not log tokens or personal data, and tell the user to review the file before sharing it anywhere else.Gets runtime evidence from a web page the agent cannot run itself, using Agent Log (austegard.com/web-utilities/agent-log.html), a script that records console calls, errors, fetch/XHR traffic and the
---name: capturing-browser-logsdescription: Gets runtime evidence from a web page the agent cannot run itself, using Agent Log…---# capturing-browser-logs/SKILL.md概览
Gets runtime evidence from a web page the agent cannot run itself, using Agent Log (austegard.com/web-utilities/agent-log.html), a script that records console calls, errors, fetch/XHR traffic and the events and DOM changes of elements the user picks, as OpenTelemetry logs in the user's browser. Use when debugging a page, web app, browser game or bookmarklet that misbehaves on the user's device, when the user says "it doesn't work" about a page and you need to see what happened, when you want to add console.log instrumentation and read it back, when you need to see what happens on a specific button, field or element, or when the user hands you an OTLP JSON log export or a file named agent-log-*.json.
常见问题
从发布者处下载 capturing-browser-logs/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/oaustegard/claude-skills。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。
dom.watch |
watch.selector, watch.matches: a watch was added or removed, or now matches a different number of elements (0 means the element is gone) |
page.navigation, page.visibility, agentlog.start, agentlog.stop | url.full, navigation.type, page.visibility |