Skip to content

Add commands for listing queryable fields & counting - #135

Merged
ninoseki merged 6 commits into
mainfrom
queryable-fields
Jul 7, 2026
Merged

Add commands for listing queryable fields & counting#135
ninoseki merged 6 commits into
mainfrom
queryable-fields

Conversation

@ninoseki

@ninoseki ninoseki commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

When asking an agent to search something with this CLI, I always instruct:

  • You can get queryable fields by urlscan user | jq .limits.queryableFields.
  • You can quikly count a number of search results by using size=0 (urlscan search <query> --size 0 | jq .total)

It's bit bothersome and I think it's good to have dedicated commands:

$ urlscan search fields
[
  "annotations.*",
  "asn",
  "asnname.*",
   ...
]

$ urlsacn search count "page.example.com"
10000                              

I guess it also allows an agent to auto-discover them without instruction (low confidence / at least Claude Opus 4.7 uses count command automatically without a hint).

@ninoseki ninoseki changed the title Add command for listing queryable fields Add commands for listing queryable fields & counting Jul 6, 2026
@ninoseki
ninoseki requested review from cdnsyseng, dawnstar and fw42 July 7, 2026 01:02
@ninoseki
ninoseki marked this pull request as ready for review July 7, 2026 01:02
@ninoseki
ninoseki merged commit 194cc72 into main Jul 7, 2026
4 checks passed
@ninoseki
ninoseki deleted the queryable-fields branch July 7, 2026 08:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants