observe
Query Crawlio's observation log — the append-only timeline of everything Crawlio observed during a crawl session.
When to Use
Use this skill when the user wants to:
- See what happened during a crawl
- Review extension captures (framework detection, network requests, console logs)
- Reconstruct a timeline of events
- Find specific observations by host, source, or time range
Quick Reference
Get Recent Observations
get_observations({ limit: 20 })Filter by Host
get_observations({ host: "example.com", limit: 50 })Filter by Source
| Source | What It Captures |
|---|---|
extension | Chrome extension enrichment (framework, network, console, DOM) |
engine | Crawl lifecycle events (crawl_start, crawl_done) |
webkit | WebKit runtime capture |
agent | AI-created findings |
get_observations({ source: "extension", limit: 30 })Filter by Operation
| Op | Meaning |
|---|---|
observe | Raw data capture |
finding | Agent-created insight |
crawl_start | Crawl began |
crawl_done | Crawl completed |
page | Single page observation |
get_observations({ op: "crawl_done" })Time-Based Query
Use Unix timestamps to query a time range:
get_observations({ since: 1708444200, limit: 100 })Combine Filters
get_observations({
host: "example.com",
source: "extension",
op: "observe",
limit: 50
})Single Observation Lookup
Look up a specific observation or finding by ID:
get_observation({ id: "obs_a1b2c3d4" })Use this to verify evidence referenced by findings, or to inspect the full payload of an evidenceId returned by analyze_page. Works with both obs_xxx (observation) and fnd_xxx (finding) IDs.
Reading Observations
Each observation entry contains:
- id — unique identifier (
obs_prefix for observations,fnd_for findings) - op — what type of event this is
- ts — ISO 8601 timestamp
- url — the URL this relates to
- source — what produced this entry
- data — composite payload (framework detection, network requests, console logs, progress, etc.)
Common Patterns
Timeline Reconstruction
Query by host with no limit to see the full story of a crawl:
get_observations({ host: "example.com" })Crawl Summary
Get start and end events to see crawl performance:
get_observations({ op: "crawl_start" })
get_observations({ op: "crawl_done" })The crawl_done entry includes progress data (totalDiscovered, downloaded, failed).
Extension Audit
See everything the Chrome extension captured:
get_observations({ source: "extension", limit: 200 })Evidence Chain Verification
Verify evidence referenced by a finding:
get_observation({ id: "obs_a1b2c3d4" })This returns the full observation entry. Use it to confirm that evidence IDs in findings actually support the claimed insight.
After Observation — Create Findings
Once you've identified patterns in observations, use the finding skill to record insights with evidence chains.