{"skill":{"slug":"wip-grok","displayName":"Wip Grok","summary":"xAI Grok API. Search the web, search X, generate images, generate video.","description":"---\nname: wip-grok\nversion: 1.0.2\ndescription: xAI Grok API. Search the web, search X, generate images, generate video.\nhomepage: https://github.com/wipcomputer/wip-grok\nmetadata:\n  category: search,media\n  api_base: https://api.x.ai/v1\n  capabilities:\n    - api\n    - web-search\n    - x-search\n    - image-generation\n    - image-editing\n    - video-generation\n  dependencies: []\n  interface: REST\nopenclaw:\n  emoji: \"🔍\"\n  install:\n    env:\n      - XAI_API_KEY\nauthor:\n  name: Parker Todd Brooks\n---\n\n# wip-grok\n\nxAI Grok API. Sensor (search) + Actuator (generate). All xAI functions in one tool.\n\n## When to Use This Skill\n\n### Sensor: Search\n\n**Use search_web for:**\n- Current information from websites, news, documentation\n- Real-time data (stock prices, weather, recent events)\n- Finding information from specific domains\n- Verifying current facts\n\n**Use search_x for:**\n- What people are saying on X/Twitter about a topic\n- Trending discussions and social sentiment\n- Real-time reactions to events\n- Posts from specific X handles/users\n\n### Actuator: Generate\n\n**Use generate_image for:**\n- Creating images from text descriptions\n- Generating multiple variations of a concept\n- Creating images with specific aspect ratios\n\n**Use edit_image for:**\n- Modifying existing images with natural language\n- Style transfer, color changes, adding/removing elements\n- Combining up to 3 source images\n\n**Use generate_video for:**\n- Creating short video clips (1-15 seconds)\n- Animating still images (image-to-video)\n- Text-to-video generation\n\n### Do NOT Use For\n\n- Fetching a specific X post by URL (use wip-x fetch_post instead)\n- Posting tweets (use wip-x post_tweet)\n- Reading bookmarks (use wip-x get_bookmarks)\n- Historical facts that won't change\n- Mathematical calculations\n\n## API Reference\n\n### search_web(options)\n\n```javascript\nconst result = await search_web({ query: \"latest news about AI\" });\n// result: { content, citations, usage, raw_response }\n```\n\nOptions: query (required), model, allowed_domains (max 5), excluded_domains (max 5), enable_image_understanding\n\n### search_x(options)\n\n```javascript\nconst result = await search_x({ query: \"AI thoughts\", allowed_x_handles: [\"elonmusk\"] });\n```\n\nOptions: query (required), model, allowed_x_handles (max 10), excluded_x_handles (max 10), from_date, to_date, enable_image_understanding, enable_video_understanding\n\n### generate_image(options)\n\n```javascript\nconst result = await generate_image({ prompt: \"a red cube\", n: 1, aspect_ratio: \"1:1\" });\n// result: { images: [{ url, revised_prompt }] }\n```\n\nOptions: prompt (required), model, n (1-10), response_format (\"url\"|\"b64_json\"), aspect_ratio\n\nCost: $0.02 per image. URLs are temporary ... download promptly.\n\n### edit_image(options)\n\n```javascript\nconst result = await edit_image({ prompt: \"make it blue\", image: \"https://...\" });\n```\n\nOptions: prompt (required), image (required, URL or file path or base64), model, n, response_format\n\nCost: $0.022 per image (input + output).\n\n### generate_video(options)\n\n```javascript\nconst { request_id } = await generate_video({ prompt: \"sunset timelapse\", duration: 10 });\nconst result = await wait_for_video({ request_id });\n// result: { status: \"completed\", url: \"https://...\" }\n```\n\nOptions: prompt (required), model, duration (1-15 sec), resolution (\"480p\"|\"720p\"), aspect_ratio, image (seed image URL)\n\nCost: $0.05/sec at 480p, $0.07/sec at 720p. URLs are temporary.\n\n### poll_video(options) / wait_for_video(options)\n\nPoll or wait for async video generation. wait_for_video is a convenience wrapper that polls until complete or timeout.\n\n## Troubleshooting\n\n### \"XAI_API_KEY not found\"\nSet via environment or 1Password: `op://Agent Secrets/X API/api key`\n\n### Slow search responses\nGrok reasoning models can take 30-60+ seconds. This is normal.\n\n### Temporary URLs\nImage and video URLs expire. Download or process them immediately after receiving.\n\n## API Documentation\n\n- Web Search: https://docs.x.ai/developers/tools/web-search\n- X Search: https://docs.x.ai/developers/tools/x-search\n- Image Generation: https://docs.x.ai/docs/guides/image-generations\n- Video Generation: https://docs.x.ai/docs/guides/video-generations\n","topics":["Web Search","Search The Web"],"tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":1026,"installsAllTime":39,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1771700110011,"updatedAt":1778992165597},"latestVersion":{"version":"1.0.2","createdAt":1771700110011,"changelog":"Release.","license":null},"metadata":null,"owner":{"handle":"parkertoddbrooks","userId":"s17620xzyc7kfan8m36at57m6n83h8he","displayName":"Parker Todd Brooks","image":"https://avatars.githubusercontent.com/u/585456?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779948100046}}