Agent Skills

cnki-advanced-search

Perform advanced search on CNKI with field filters like author, title, journal, date range, source category (SCI/EI/CSSCI/北大核心). Use when user needs precise filtered search beyond simple keywords.

Install

npx skills add https://github.com/cookjohn/cnki-skills --skill cnki-advanced-search
SKILL.md

CNKI Advanced Search (高级检索)

Perform a filtered search on CNKI using the old-style advanced search interface (only interface with source category checkboxes).

Arguments

$ARGUMENTS describes the search criteria in natural language. Parse it to identify:

  • Subject keywords (主题) — default field
  • Title keywords (篇名)
  • Keywords (关键词)
  • Author name (作者) — separate field #au_1_value1
  • Journal/source (文献来源) — separate field #magazine_value1
  • Date range (时间范围) — #startYear / #endYear
  • Source category (来源类别:SCI, EI, 北大核心, CSSCI, CSCD)

Steps

1. Navigate

Use mcp__chrome-devtools__navigate_page → https://kns.cnki.net/kns/AdvSearch?classid=7NS01R8M

2. Search + get results (single async evaluate_script)

Replace placeholder values with actual search criteria:

async () => {
  // --- Config: fill in actual values ---
  const query = "KEYWORDS";          // row 1 search keywords
  const fieldType = "SU";           // SU=主题, TI=篇名, KY=关键词, TKA=篇关摘, AB=摘要
  const query2 = "";                // row 2 keywords (optional, "" to skip)
  const fieldType2 = "KY";          // row 2 field type
  const rowLogic = "AND";           // AND=并且, OR=或者, NOT=不含 (between row 1 and 2)
  const sourceTypes = ["CSSCI"];    // any of: "SCI", "EI", "hx", "CSSCI", "CSCD" ([] = all)
  const startYear = "";             // e.g. "2020" or "" for no limit
  const endYear = "";               // e.g. "2025" or "" for no limit
  const author = "";                // author name or ""
  const journal = "";               // journal name or ""

  // --- Wait for form ---
  await new Promise((r, j) => {
    let n = 0;
    const c = () => { if (document.querySelector('#txt_1_value1')) r(); else if (n++ > 30) j('timeout'); else setTimeout(c, 500); };
    c();
  });

  // Captcha check
  const cap = document.querySelector('#tcaptcha_transform_dy');
  if (cap && cap.getBoundingClientRect().top >= 0) return { error: 'captcha' };

  const selects = Array.from(document.querySelectorAll('select')).filter(s => s.offsetParent !== null);

  // --- Source type: uncheck 全部, check targets ---
  if (sourceTypes.length > 0) {
    const gjAll = document.querySelector('#gjAll');
    if (gjAll && gjAll.checked) gjAll.click();
    for (const st of sourceTypes) {
      const cb = document.querySelector('#' + st);
      if (cb && !cb.checked) cb.click();
    }
  }

  // --- Row 1: field type + keyword ---
  selects[0].value = fieldType;
  selects[0].dispatchEvent(new Event('change', { bubbles: true }));
  const input = document.querySelector('#txt_1_value1');
  input.value = query;
  input.dispatchEvent(new Event('input', { bubbles: true }));

  // --- Row 2: field type + keyword (optional) ---
  if (query2) {
    selects[5].value = rowLogic; // row logic: AND/OR/NOT
    selects[5].dispatchEvent(new Event('change', { bubbles: true }));
    selects[6].value = fieldType2;
    selects[6].dispatchEvent(new Event('change', { bubbles: true }));
    const input2 = document.querySelector('#txt_2_value1');
    input2.value = query2;
    input2.dispatchEvent(new Event('input', { bubbles: true }));
  }

  // --- Author (optional) ---
  if (author) {
    const auInput = document.querySelector('#au_1_value1');
    if (auInput) { auInput.value = author; auInput.dispatchEvent(new Event('input', { bubbles: true })); }
  }

  // --- Journal (optional) ---
  if (journal) {
    const magInput = document.querySelector('#magazine_value1');
    if (magInput) { magInput.value = journal; magInput.dispatchEvent(new Event('input', { bubbles: true })); }
  }

  // --- Date range (optional) ---
  if (startYear) { selects[14].value = startYear; selects[14].dispatchEvent(new Event('change', { bubbles: true })); }
  if (endYear) { selects[15].value = endYear; selects[15].dispatchEvent(new Event('change', { bubbles: true })); }

  // --- Submit ---
  document.querySelector('div.search')?.click();

  // Wait for results
  await new Promise((r, j) => {
    let n = 0;
    const c = () => {
      if (document.body.innerText.includes('条结果')) r();
      else if (n++ > 40) j('timeout');
      else setTimeout(c, 500);
    };
    setTimeout(c, 2000);
  });

  // Captcha check again
  const cap2 = document.querySelector('#tcaptcha_transform_dy');
  if (cap2 && cap2.getBoundingClientRect().top >= 0) return { error: 'captcha' };

  return {
    query, fieldType, query2, fieldType2, rowLogic,
    sourceTypes, startYear, endYear, author, journal,
    total: document.querySelector('.pagerTitleCell')?.innerText?.match(/([\d,]+)/)?.[1] || '0',
    page: document.querySelector('.countPageMark')?.innerText || '1/1',
    url: location.href
  };
}

3. Report

Advanced search: "{query}" ({fieldType}) + source: {sourceTypes} → {total} results.

Tool calls: 2 (navigate + evaluate_script)

Verified selectors (old-style interface)

Form fields

Element Selector / Select index Notes
行1 字段类型 selects[0] SU=主题, TI=篇名, KY=关键词, TKA=篇关摘, AB=摘要
行1 关键词 #txt_1_value1 main keyword input
行1 行内第二词 #txt_1_value2 same-row AND/OR/NOT with first keyword
行1 行内逻辑 selects[2] AND=并含, OR=或含, NOT=不含
行间逻辑 selects[5] AND=并且, OR=或者, NOT=不含
行2 字段类型 selects[6] same options as row 1
行2 关键词 #txt_2_value1 second row keyword
行2 行内第二词 #txt_2_value2
作者 #au_1_value1 placeholder "中文名/英文名/拼音"
作者单位 #au_1_value2 placeholder "全称/简称/曾用名"
文献来源 #magazine_value1 placeholder "期刊名称/ISSN/CN"
基金 #base_value1
起始年 selects[14] / #startYear <select> 1915-2026
结束年 selects[15] / #endYear <select> 2026-1915
检索按钮 div.search NOT input/button

Source type checkboxes (来源类型)

来源 Checkbox ID Notes
全部期刊 #gjAll 默认勾选,选其他前需取消
SCI来源期刊 #SCI value="Y"
EI来源期刊 #EI value="Y"
北大核心期刊 #hx value="Y"
CSSCI #CSSCI value="Y"
CSCD #CSCD value="Y"

Multiple source types can be checked simultaneously (OR logic).

Results

Element Selector Notes
Result count .pagerTitleCell text "共找到 X 条结果"
Page indicator .countPageMark text "1/300"

Captcha detection

Check #tcaptcha_transform_dy element's getBoundingClientRect().top >= 0.

Important Notes

  • Must use old-style URL (kns.cnki.net/kns/AdvSearch). New interface (kns8s/AdvSearch) has NO source category checkboxes.
  • The classid=7NS01R8M parameter ensures the correct form layout loads.
  • Results page is compatible with cnki-parse-results and cnki-navigate-pages skills.

Related skills

researchmattpocock575KInvestigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.paper-context-resolverlllllllama451KRigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing Renv-and-assets-bootstraplllllllama450KRigor Setup skill for README-first deep learning repo reproduction. Use when the task is specifically to prepare a conservative conda-first environment, checkpoint and dataset path assumptions, cache location hints, and setup notes before any run on a README-documented repository. Do not use for repo scanning, full orchestration, paper interpretation, final run reporting, or generic environment setup that is not tied to a specific reproduction target.ai-research-explorelllllllama311KRigor Explore compatible skill slug for meaningful and potentially novel deep learning research candidates. Use when the researcher has chosen the task family, dataset, benchmark, evaluation method, provided SOTA references, and wants candidate-only exploration on top of `current_research` with auditable repo understanding, idea gating, fair comparison, and governed experiments written to `explore_outputs/`. Do not use for README-first trusted reproduction, open-ended direction finding, narrow c

Search skills and MCP servers

Fuzzy search across 23,137 skills and servers