@acedatacloud/skills 2026.706.3 → 2026.712.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.706.3",
+  "version": "2026.712.0",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/google-search/SKILL.md

@@ -58,6 +58,7 @@ POST /serp/google
 | `range` | string | Time filter (see below) |
 | `number` | int | Number of results per page |
 | `page` | int | Page number for pagination |
+| `image_size` | string | **Images only.** Filter by size for high-res sources: `large` / `medium` / `icon`, or a megapixel minimum `2mp`…`70mp` (e.g. `4mp` = larger than 4 megapixels). Use `large` (or a `*mp` value) whenever the image will be shown large / full-screen / zoomed. |
 
 ## Time Range Options
 
@@ -82,7 +83,7 @@ Web search returns structured data including:
 - Country and language codes affect result localization significantly
 - `number` controls results per page, not total results — use `page` for pagination
 - Time range (`range`) only applies to web search and news, not images or places
-- Image search returns thumbnail and full-size URLs — use full-size for downloads
+- **Image resolution (important for video / full-screen use):** results include `image_url` (full-size), `thumbnail_url`, and `image_width`/`image_height`. Pass **`image_size: "large"`** (or a megapixel minimum like `"4mp"`) to get sharp sources, and pick the result with the largest `image_width`×`image_height`. Always download `image_url` — **never** use `thumbnail_url` as a final asset (it is tiny and blurry).
 - Places search works best with location-specific queries (e.g., "restaurants near Times Square")
 
 > **MCP:** `pip install mcp-serp` | Hosted: `https://serp.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/x/scripts/x.py

@@ -98,6 +98,7 @@ def current_user_id_from_cookies() -> str | None:
 
 
 def make_client():
+    import httpx
     from twikit import Client
     patch_twikit_transaction_resolver()
     patch_twikit_model_defaults()
@@ -107,7 +108,12 @@ def make_client():
         or os.environ.get("ALL_PROXY") or os.environ.get("all_proxy")
         or None
     )
-    client = Client("en-US", proxy=proxy, user_agent=UA)
+    # twikit builds its httpx.AsyncClient with httpx's 5s default timeout, which
+    # trips a ReadTimeout on media uploads (INIT/APPEND/FINALIZE + status poll)
+    # from datacenter egress — a text-only tweet is one fast call and squeaks
+    # under 5s, but --media does not. Give network ops generous headroom.
+    timeout = httpx.Timeout(60.0, connect=15.0)
+    client = Client("en-US", proxy=proxy, user_agent=UA, timeout=timeout)
     client.set_cookies(load_cookie_dict())
     return client
 
@@ -494,6 +500,14 @@ def main() -> None:
         # twikit scrapes X's non-public API; a bare error here usually means an
         # expired cookie OR that X changed its internal endpoints and twikit
         # needs a compatibility fix.
+        import httpx
+        if isinstance(e, httpx.TimeoutException):
+            die(
+                "X request timed out talking to X (network was slow, not an "
+                "auth problem) — this is transient, retry the same command. "
+                "Timeouts are most common on --media because the image upload "
+                "is the slow leg; if it recurs, try a smaller image."
+            )
         if "Couldn't get KEY_BYTE indices" in str(e):
             die(
                 "X request failed because twikit cannot derive X's current "