SuperAPI AI Directory

quark-search

Coding & development

View repository

Updated 10-15 21:41

About this skill

Quark Search — Cloud Drive Resource Search and Download

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:

Param Description Example
q Search keyword (required) q=三体
page Page number page=1
limit Results per page limit=20
type Filter by drive type type=quark
source Filter by source source=plugin:libvio

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:

code Meaning Action
0 Valid share Proceed. Extract stoken from response for detail query
41006 Share does not exist (分享不存在) Skip, mark as invalid
41004 Share expired (分享已过期) Skip, mark as expired
Other non-zero Other error Skip

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:

The share link window has been opened in the Quark APP. Please tap the "Save to Cloud Drive" button in the APP to complete saving. After saving, the file will appear in the "From: Shares" folder in your cloud drive, and you can download it directly to your local device in the 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

Error Detection Resolution
Quark APP not running localhost:9128 connection refused Tell user to launch Quark APP
Not logged in desktop_info returns isLogin: false Tell user to log in
No search results PanSou returns total: 0 Suggest different keywords
All links invalid All validation checks fail Try alternative drive types or different keywords
Share has password Token API returns password required error Ask user for the extraction code (提取码)

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