Quark Search — 网盘资源搜索与下载

Automate the full workflow: search resources → validate links → save to Quark cloud drive → download locally, by combining the PanSou aggregation API with the local Quark desktop APP.

Prerequisites Check

Before any operation, verify the environment:

# Check Quark APP status and login
curl -s "http://localhost:9128/desktop_info" | python3 -m json.tool

Expected: isLogin: true. If the APP is not running or not logged in, instruct the user to launch Quark and log in first.

Workflow

Step 1: Search Resources (PanSou API)

# Search with keyword, returns results grouped by cloud drive type
curl -s "https://s.panhunt.com/api/search?q=KEYWORD&page=1&limit=20"

Response structure:

{
  "code": 0,
  "data": {
    "total": 1234,
    "merged_by_type": {
      "quark": [{"url": "https://pan.quark.cn/s/xxx", "note": "资源名", "source": "plugin:libvio", "datetime": "..."}],
      "baidu": [...],
      "aliyun": [...],
      "115": [...],
      "pikpak": [...],
      "uc": [...]
    }
  }
}

Parameters:

JSON parsing note: PanSou API responses may contain invalid escape sequences. Always parse with json.loads(raw, strict=False) in Python.

Priority: Always prioritize quark type results since the user has Quark membership. Fall back to aliyun, uc, baidu etc. if no quark results.

Step 2: Validate Links

Before presenting results to the user, validate each candidate link. Extract pwd_id from the share URL (https://pan.quark.cn/s/{pwd_id}), then:

# Get share token and check validity
curl -s -X POST "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/token?pr=ucpro&fr=pc" \
  -H "content-type: application/json" \
  -d '{"pwd_id":"PWD_ID_HERE","passcode":""}'

Interpret response:

Step 3: Get File Details

For valid links, fetch the file list to show the user what’s inside:

curl -s "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/detail?pr=ucpro&fr=pc&pwd_id=PWD_ID&stoken=STOKEN_URL_ENCODED&pdir_fid=0&force=0&_page=1&_size=50&_sort=file_type:asc,updated_at:desc" \
  -H "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

Extract from response:

• data.list[].file_name — file/folder name
• data.list[].size — file size (bytes, 0 for folders)
• data.list[].include_items — number of items in folder
• data.list[].file_type — 0=folder, 1=file
• metadata._total — total items in share

Step 4: Present Results to User

Format results clearly:

搜索 "三体" 找到 X 个有效夸克网盘资源：

1. [有效] 三体全集 4K — 3个文件，来源: plugin:libvio
   https://pan.quark.cn/s/abc123
2. [有效] 三体 第一季 1080P — 1个文件夹(42项)，来源: channel:yunpanx
   https://pan.quark.cn/s/def456
3. [已失效] 三体合集 — 分享已过期

Ask the user which one to save.

Step 5: Trigger Quark APP Save

When the user selects a resource, trigger the Quark APP to open the share link:

# Method 1: via desktop_share_visiting (preferred, opens share view window)
curl -s "http://localhost:9128/desktop_share_visiting?pwd_id=PWD_ID_HERE"

# Method 2: via desktop_caller with deeplink (alternative)
curl -s "http://localhost:9128/desktop_caller?deeplink=qkclouddrive%3A%2F%2Fsave%3Furl%3Dhttps%253A%252F%252Fpan.quark.cn%252Fs%252FPWD_ID_HERE"

After triggering, inform the user:

已在夸克 APP 中打开分享链接窗口。请在 APP 中点击「保存到网盘」按钮完成保存。保存后文件会出现在你的网盘「来自：分享」文件夹中，可以直接在 APP 中下载到本地。

Step 6: Batch Processing

When the user wants to search and save multiple resources, loop through steps 1-5 for each keyword. Validate all links first, then trigger APP saves sequentially with a brief delay between each.

Error Handling

Health Check Endpoint

To check PanSou API status and supported sources:

curl -s "https://s.panhunt.com/api/health"

Returns: channels_count (Telegram channels), plugin_count (website plugins), status.

Important Notes

• All share validation APIs are public (no authentication needed)
• The local Quark APP API at localhost:9128 requires no authentication
• The actual save-to-drive operation happens in the Quark APP UI (user clicks one button)
• Download-to-local is handled by Quark APP’s built-in download manager
• Do not attempt to call Quark’s authenticated remote APIs directly