skills/omnibox-api/SKILL.md
Interact with OmniBox API to create resources, upload files, collect web content from URLs, and ask questions to the AI wizard. Use when the user mentions OmniBox, omnibox, collecting URLs, saving web pages, or querying the OmniBox assistant.
npx skillsauth add benature/skills-productivity omnibox-apiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Base URL: https://api.omnibox.pro
Auth: Authorization: Bearer <API_KEY> header on all requests.
| Method | Path | Description | |--------|------|-------------| | GET | /v1/api-keys/info | Get API key info | | DELETE | /v1/api-keys | Delete API key | | POST | /v1/resources | Create a resource/document | | POST | /v1/resources/upload | Upload a file as resource | | POST | /v1/wizard/collect/gzip | Collect web content (gzip HTML) | | POST | /v1/wizard/collect/url | Collect content from a URL | | POST | /v1/wizard/ask | Ask AI wizard a question |
curl -X POST 'https://api.omnibox.pro/v1/resources' \
-H 'Authorization: Bearer $OMNIBOX_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"name": "My Document",
"content": "Document content here. #tag1 #tag2",
"tag_ids": [],
"attrs": {},
"skip_parsing_tags_from_content": false
}'
Response: { "id": "...", "name": "..." }
curl -X POST 'https://api.omnibox.pro/v1/resources/upload' \
-H 'Authorization: Bearer $OMNIBOX_API_KEY' \
-F 'file=@/path/to/file.pdf' \
-F 'parsed_content=Optional pre-parsed text'
Response: { "id": "...", "name": "..." }
Simplest way to save a web page:
curl -X POST 'https://api.omnibox.pro/v1/wizard/collect/url' \
-H 'Authorization: Bearer $OMNIBOX_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com/article",
"parentId": "optional-parent-resource-id"
}'
Response: { "resource_id": "..." }
For saving a page with its full HTML content:
echo '<html>...</html>' | gzip > /tmp/html.gz
curl -X POST 'https://api.omnibox.pro/v1/wizard/collect/gzip' \
-H 'Authorization: Bearer $OMNIBOX_API_KEY' \
-F 'url=https://example.com/page' \
-F 'title=Page Title' \
-F 'html=@/tmp/html.gz;type=application/gzip;filename=html.gz'
curl -X POST 'https://api.omnibox.pro/v1/wizard/ask' \
-H 'Authorization: Bearer $OMNIBOX_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"query": "What are the main topics in my recent articles?",
"tools": [],
"enable_thinking": true,
"lang": "简体中文",
"parent_message_id": ""
}'
lang options: "简体中文" | "English"
OMNIBOX_API_KEY for the API key. Never hardcode.parentId in collect endpoints is optional; omit to use root resource.tag_ids accepts UUID strings for existing tags.#hashtag syntax for auto-tagging (disable with skip_parsing_tags_from_content: true).development
Call Agnes AI APIs for image generation, image editing, text-to-video, image-to-video, multi-image video, and keyframe animation. Uses API key from ~/.config/agnes-ai/api_key without printing it.
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
development
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
development
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.