name: suppr-search-articles description: 超能文獻（Suppr）學術文獻檢索 API。當用戶需要檢索學術論文、查詢 PubMed 文獻、搜尋研究資料時啟用。

超能文獻學術文獻檢索 API

超能文獻（Suppr）提供基於 PubMed 的 AI 語義文獻檢索服務，支援自然語言查詢和豐富的文獻後設資料返回。

• API 基礎地址：https://api.suppr.wilddata.cn
• API 文件：https://openapi.suppr.wilddata.cn/introduction.html
• 認證方式：Authorization: Bearer <your_api_key>

何時啟用

• 使用者需要檢索學術論文或文獻
• 使用者需要搜尋 PubMed 資料庫

  小蔥技能站7w4.net每天更新，海量AI技能等你發現。

• 使用者需要查詢特定主題的研究資料
• 使用者需要獲取論文的 DOI、PMID、影響因子等後設資料

API 端點

語義文獻檢索

POST https://api.suppr.wilddata.cn/v1/docs/semantic_search
Content-Type: application/json
Authorization: Bearer <your_api_key>

請求體引數：

return_doc_keys 完整欄位列表

常用欄位組合

快速概覽

{
  "query": "糖尿病最新研究進展",
  "topk": 10,
  "return_doc_keys": ["title", "abstract", "pub_year"],
  "auto_select": true
}

引用格式

{
  "query": "CRISPR gene editing therapy",
  "topk": 20,
  "return_doc_keys": ["title", "doi", "pmid", "authors", "publication", "pub_year", "pub_volume", "pub_issue", "pub_page"],
  "auto_select": true
}

完整後設資料

{
  "query": "machine learning drug discovery",
  "topk": 5,
  "return_doc_keys": ["title", "abstract", "doi", "pmid", "pmcid", "impact_factor", "authors", "pub_year", "publication", "cited_by_num"],
  "auto_select": true
}

響應格式

{
  "code": 0,
  "data": {
    "search_items": [
      {
        "doc": {
          "title": "論文標題",
          "abstract": "論文摘要...",
          "doi": "10.1007/xxxxx",
          "pmid": "35397038",
          "authors": [
            {
              "fore_name": "名",
              "last_name": "姓",
              "affiliations": [
                { "name": "所屬機構" }
              ]
            }
          ],
          "publication": "期刊名稱",
          "pub_year": 2024,
          "impact_factor": 5.2
        },
        "search_gateway": "pubmed"
      }
    ],
    "consumed_points": 20
  },
  "msg": ""
}

code 為 0 表示成功，非 0 表示錯誤。

使用示例

curl -X POST https://api.suppr.wilddata.cn/v1/docs/semantic_search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "阿茲海默症早期診斷生物標誌物",
    "topk": 10,
    "return_doc_keys": ["title", "abstract", "doi", "pmid", "pub_year", "impact_factor"],
    "auto_select": true
  }'

注意事項

• topk 為期望返回的最大數量，實際返回可能少於該值（取決於檢索結果）
• 不指定 return_doc_keys 時返回預設欄位集
• auto_select 為 true 時，AI 會自動篩選與查詢最相關的結果
• 速率限制：60 次/分鐘

這是一個用於檢索學術論文的工具，可以幫助查詢 PubMed 文獻、獲取論文摘要和後設資料。整體質量良好，文件清晰易懂，功能描述完整，能滿足基本的文獻檢索需求。主要不足是對於普通使用者來說，缺少實際使用案例演示，也沒有說明是否需要付費或如何註冊賬號，使用前需要一定的技術基礎。適合有一定程式設計能力的使用者使用。