Skip to content

itarunnn/jp-lit-mcp / skills/jp-lit-research

jp-lit-research

Verified

日本語人文社会系文献調査スキル。jp-lit MCP サーバーを使って NDL・CiNii・J-STAGE・IRDB・JDCat・NIHU Bridge・国会会議録などを横断検索し、 書誌確認・所蔵調査・テーマ文献探索・古語表記ゆれ検索・デジコレ全文OCR・図版検索を行う。 「文献DBで調べて」「文献DBを始めます」など、文献DB という起動語を明示した文献調査依頼で使用する。 一度発火したらセッション中は継続して調査を進める。 SKIP: 「調べて」単体・API ドキュメント調査・Web 検索・一般的な質問への説明。

scripts/plan-regional-library-search.mjs

View on GitHub
#!/usr/bin/env node

import { readFileSync } from "node:fs";

const FIELD_TYPES = [
  ["prefectureNames", "prefecture"],
  ["cityNames", "city"],
  ["placeNames", "place"],
  ["publicationPlaces", "publication_place"],
  ["activityPlaces", "activity_place"],
  ["adjacentPlaces", "adjacent_place"],
  ["oldDistrictNames", "old_district"]
];

function unique(values) {
  const seen = new Set();
  const result = [];
  for (const value of values) {
    if (typeof value !== "string") {
      continue;
    }
    const normalized = value.trim();
    if (!normalized || seen.has(normalized)) {
      continue;
    }
    seen.add(normalized);
    result.push(normalized);
  }
  return result;
}

function arrayField(input, key) {
  return Array.isArray(input?.[key]) ? unique(input[key]) : [];
}

function readInput() {
  const raw = readFileSync(0, "utf8").trim();
  if (!raw) {
    return {};
  }
  return JSON.parse(raw);
}

function libraryKeywords(label, type) {
  if (type === "prefecture") {
    const keywords = [
      `${label}立図書館`,
      `${label} 図書館`,
      `${label} 郷土資料`
    ];
    if (label === "東京都" || label === "大阪府") {
      keywords.splice(1, 0, `${label}立中央図書館`);
    }
    return keywords;
  }
  if (type === "city") {
    return [`${label} 中央図書館`, `${label} 図書館`, `${label} 郷土資料`];
  }
  if (type === "publication_place" || type === "activity_place") {
    return [`${label} 中央図書館`, `${label} 図書館`, `${label} 郷土資料`];
  }
  if (type === "adjacent_place" || type === "old_district") {
    return [`${label} 図書館`, `${label} 郷土資料`, `${label} 史料`];
  }
  return [`${label} 図書館`, `${label} 郷土資料`, `${label} 中央図書館`];
}

function webSearchQueries(label, type) {
  if (type === "prefecture") {
    return [
      `${label} 図書館 郷土資料`,
      `${label} 都道府県立図書館 パスファインダー`,
      `${label} 新聞 所蔵 図書館`
    ];
  }
  if (type === "city" || type === "place") {
    return [
      `${label} 中央図書館 郷土資料`,
      `${label} 図書館 パスファインダー`,
      `${label} 郷土資料 図書館`
    ];
  }
  if (type === "publication_place" || type === "activity_place") {
    return [
      `${label} 中央図書館`,
      `${label} 郷土資料 図書館`,
      `${label} 地域資料 図書館`
    ];
  }
  if (type === "adjacent_place" || type === "old_district") {
    return [
      `${label} 郷土資料 図書館`,
      `${label} 史料 図書館`,
      `${label} パスファインダー`
    ];
  }
  return [`${label} 図書館`, `${label} 郷土資料`];
}

function inferPrefecture(label) {
  const match = label.match(/^(.*?[都道府県])/);
  return match?.[1] ?? null;
}

function buildRegionCandidates(input) {
  const candidates = [];
  const seenLabels = new Set();
  for (const field of ["cityNames", "placeNames", "publicationPlaces", "activityPlaces"]) {
    for (const label of arrayField(input, field)) {
      const pref = inferPrefecture(label);
      if (!pref || seenLabels.has(pref)) {
        continue;
      }
      seenLabels.add(pref);
      candidates.push({
        label: pref,
        type: "prefecture",
        webSearchQueries: webSearchQueries(pref, "prefecture"),
        searchLibrariesKeywords: libraryKeywords(pref, "prefecture")
      });
    }
  }
  for (const [field, type] of FIELD_TYPES) {
    for (const label of arrayField(input, field)) {
      if (seenLabels.has(label)) {
        continue;
      }
      seenLabels.add(label);
      candidates.push({
        label,
        type,
        webSearchQueries: webSearchQueries(label, type),
        searchLibrariesKeywords: libraryKeywords(label, type)
      });
    }
  }
  return candidates;
}

function buildSpecialistLibraryCandidates(input) {
  const labels = unique([
    ...arrayField(input, "specialistLibraryNames"),
    ...arrayField(input, "specialistLibraryKeywords"),
    ...arrayField(input, "subjectKeywords")
  ]);

  return labels.map((label) => ({
    label,
    type: "specialist_keyword",
    searchLibrariesKeywords: [
      label,
      `${label} 専門図書館`,
      `${label} 資料室`,
      `${label} 図書館`,
      `${label} 博物館`,
      `${label} アーカイブ`
    ]
  }));
}

function buildSpecialistDiscoveryQueries(input) {
  const subjects = unique([
    ...arrayField(input, "subjectKeywords"),
    ...arrayField(input, "specialistLibraryKeywords")
  ]);
  const people = arrayField(input, "personNames");
  const queries = [];
  const seen = new Set();

  for (const subject of subjects) {
    addQuery(queries, seen, "専門領域 + 専門資料機関", `${subject} 専門図書館 OR 資料室 OR アーカイブ`);
    addQuery(queries, seen, "専門領域 + 博物館/記念館", `${subject} 博物館 OR 記念館`);
    addQuery(queries, seen, "専門領域 + 団体/協会", `${subject} 協会 OR 学会 OR 研究会`);
    addQuery(queries, seen, "専門領域 + 機関誌", `${subject} 機関誌 OR 会報 OR 雑誌`);
    for (const person of people) {
      addQuery(queries, seen, "人物名 + 専門領域", `${person} ${subject}`);
      addQuery(queries, seen, "人物名 + 専門領域資料", `${person} ${subject} 資料`);
    }
  }

  return queries;
}

function buildConcreteNameDiscoveryQueries(input) {
  const people = arrayField(input, "personNames");
  const media = arrayField(input, "mediaNames");
  const organizations = arrayField(input, "organizationNames");
  const places = [
    ...arrayField(input, "placeNames"),
    ...arrayField(input, "publicationPlaces"),
    ...arrayField(input, "activityPlaces")
  ];
  const queries = [];
  const seen = new Set();

  for (const person of people) {
    addQuery(queries, seen, "人物名 + 出身地", `${person} 出身地`);
    addQuery(queries, seen, "人物名 + 地域ゆかり", `${person} ゆかり 地域`);
    addQuery(queries, seen, "人物名 + 郷土人物", `${person} 郷土人物`);
    for (const place of places) {
      addQuery(queries, seen, "人物名 + 地域確認", `${person} ${place}`);
      addQuery(queries, seen, "人物名 + 地域図書館", `${person} ${place} 図書館`);
      addQuery(queries, seen, "人物名 + 地域郷土資料", `${person} ${place} 郷土資料`);
    }
    addQuery(queries, seen, "人物名 + 図書館(補助)", `${person} 図書館`);
    addQuery(queries, seen, "人物名 + 文学館/記念館(補助)", `${person} 文学館 OR 記念館 OR 資料館`);
  }

  for (const title of media) {
    addQuery(queries, seen, "媒体名 + 所蔵図書館", `${title} 所蔵 図書館`);
    addQuery(queries, seen, "媒体名 + 新聞/雑誌所蔵", `${title} 新聞 雑誌 所蔵`);
    addQuery(queries, seen, "媒体名 + 資料室", `${title} 資料室`);
    for (const place of places) {
      addQuery(queries, seen, "媒体名 + 地域所蔵", `${title} ${place} 所蔵 図書館`);
    }
  }

  for (const organization of organizations) {
    addQuery(queries, seen, "団体名 + 記念誌/沿革", `${organization} 記念誌 沿革`);
    addQuery(queries, seen, "団体名 + 図書館", `${organization} 図書館`);
    addQuery(queries, seen, "団体名 + 資料室", `${organization} 資料室`);
    for (const place of places) {
      addQuery(queries, seen, "団体名 + 地域資料", `${organization} ${place} 郷土資料`);
    }
  }

  return queries;
}

function addQuery(queries, seen, purpose, free) {
  const normalized = free.trim();
  if (!normalized || seen.has(normalized)) {
    return;
  }
  seen.add(normalized);
  queries.push({ purpose, free: normalized });
}

function addKeywordQuery(queries, seen, purpose, keyword) {
  const normalized = keyword.trim();
  if (!normalized || seen.has(normalized)) {
    return;
  }
  seen.add(normalized);
  queries.push({ purpose, keyword: normalized });
}

function buildSearchLibrariesQueries(regionCandidates, specialistLibraryCandidates) {
  const queries = [];
  const seen = new Set();

  for (const candidate of regionCandidates) {
    for (const keyword of candidate.searchLibrariesKeywords ?? []) {
      let purpose = "地域名 + 図書館";
      if (/立図書館|立中央図書館/.test(keyword)) {
        purpose = "都道府県立図書館";
      } else if (/郷土資料/.test(keyword)) {
        purpose = "郷土資料候補";
      } else if (/中央図書館/.test(keyword)) {
        purpose = "市区町村中央館";
      }
      addKeywordQuery(queries, seen, purpose, keyword);
    }
  }

  for (const candidate of specialistLibraryCandidates) {
    for (const keyword of candidate.searchLibrariesKeywords ?? []) {
      addKeywordQuery(queries, seen, "専門資料機関候補", keyword);
    }
  }

  return queries;
}

function buildSearchBooksQueries(input) {
  const people = arrayField(input, "personNames");
  const places = arrayField(input, "placeNames");
  const activityPlaces = arrayField(input, "activityPlaces");
  const media = arrayField(input, "mediaNames");
  const organizations = arrayField(input, "organizationNames");
  const publicationPlaces = arrayField(input, "publicationPlaces");
  const adjacentPlaces = arrayField(input, "adjacentPlaces");
  const oldDistrictNames = arrayField(input, "oldDistrictNames");
  const queries = [];
  const seen = new Set();

  for (const person of people) {
    addQuery(queries, seen, "人物名", person);
    for (const place of places) {
      addQuery(queries, seen, "人物 + 地名", `${person} ${place}`);
    }
    for (const place of activityPlaces) {
      addQuery(queries, seen, "人物 + 活動地", `${person} ${place}`);
    }
  }

  for (const title of media) {
    addQuery(queries, seen, "媒体名", title);
    for (const place of publicationPlaces.length > 0 ? publicationPlaces : places) {
      addQuery(queries, seen, "媒体名 + 発行地", `${title} ${place}`);
    }
  }

  for (const organization of organizations) {
    addQuery(queries, seen, "団体名", organization);
  }

  for (const place of places) {
    addQuery(queries, seen, "地名 + 郷土史", `${place} 郷土史`);
    addQuery(queries, seen, "地名 + 人物", `${place} 人物`);
  }
  for (const place of publicationPlaces) {
    addQuery(queries, seen, "発行地 + 郷土資料", `${place} 郷土資料`);
  }
  for (const place of activityPlaces) {
    addQuery(queries, seen, "活動地 + 郷土資料", `${place} 郷土資料`);
  }
  for (const district of oldDistrictNames) {
    addQuery(queries, seen, "旧郡域 + 郷土史", `${district} 郷土史`);
  }
  for (const place of adjacentPlaces) {
    addQuery(queries, seen, "隣接自治体 + 郷土資料", `${place} 郷土資料`);
  }

  return queries;
}

function normalizeClientEnvironment(input) {
  const value = String(
    input?.clientEnvironment ?? input?.environment ?? input?.client ?? ""
  )
    .trim()
    .toLowerCase()
    .replace(/[\s_-]+/g, "_");
  if (!value) {
    return "unspecified";
  }
  if (value === "claude" || value === "claude_code") {
    return "claude_code";
  }
  if (value === "chatgpt" || value === "chat_gpt" || value === "gpt") {
    return "chatgpt";
  }
  if (value === "codex_app" || value === "codex_cli") {
    return "codex";
  }
  return value;
}

function buildCalilAccess(input, clientEnvironment) {
  const directClient =
    clientEnvironment === "cursor" ||
    clientEnvironment === "claude_code" ||
    clientEnvironment === "codex";
  const codexClient = clientEnvironment === "codex";

  return {
    clientEnvironment,
    directUse:
      codexClient
        ? "available_after_codex_mcp_login"
        : directClient
        ? "available_if_user_registered_calil_ai_remote_mcp"
        : "not_assumed",
    notes: codexClient
      ? [
          "Codex では `codex mcp add calil --url https://mcp-beta.calil.jp/mcp` と `codex mcp login calil` による直結を通常ルートにする。",
          "初回 OAuth 認可後は、保存された認証情報を使って新しい Codex セッションから search_libraries / search_books を呼ぶ。接続できない場合は MCP / OAuth 設定を直し、必要に応じて各館 OPAC や図書館レファレンスへ進む。"
        ]
      : directClient
        ? [
            "Cursor / Claude Code では、ユーザーがカーリル図書館MCPを事前登録・OAuth認可していれば同一エージェントから search_libraries / search_books を使う。",
            "カーリルの結果は jp-lit 側の NDL / CiNii / Japan Search / レファ協結果と統合評価する。"
          ]
        : [
            clientEnvironment === "chatgpt"
              ? "ChatGPT はカーリル図書館MCP側の対応先だが、この repo の jp-lit-mcp / Skill をそのまま動かす導入先ではない。"
              : "カーリル図書館MCPを同一エージェントから使えるかは実行環境の MCP / OAuth 対応に依存する。",
            "接続できない場合は、地域パスファインダー、各館 OPAC、新聞・雑誌所蔵一覧、図書館レファレンス相談を次アクションに残す。"
          ]
  };
}

function buildPlan(input) {
  const topics = arrayField(input, "topics");
  const regionCandidates = buildRegionCandidates(input);
  const specialistLibraryCandidates = buildSpecialistLibraryCandidates(input);
  const searchLibrariesQueries = buildSearchLibrariesQueries(
    regionCandidates,
    specialistLibraryCandidates
  );
  const searchBooksQueries = buildSearchBooksQueries(input);
  const clientEnvironment = normalizeClientEnvironment(input);
  const hasLocalPersonTopic = topics.some((topic) =>
    /地方人物|郷土人物|出身者|在住者/.test(topic)
  );
  const hasLocalMediaTopic = topics.some((topic) =>
    /地方紙|地方雑誌|地域紙|ミニコミ|自治体広報|機関誌/.test(topic)
  );
  const regionalSignals = unique([
    ...topics,
    ...(arrayField(input, "mediaNames").length && !hasLocalMediaTopic
      ? ["地方紙・地方雑誌"]
      : []),
    ...(arrayField(input, "organizationNames").length ? ["地域団体資料"] : [])
  ]);

  const plan = {
    mode: "regional_public_library_search_plan",
    regionalSignals,
    regionCandidates,
    libraryPriority: [
      "該当都道府県立図書館(地域資料の基準点として外さない)",
      "該当市区町村中央館",
      "県内/広域の図書館ネットワーク",
      "発行地・活動地に対応する中央館",
      "郷土資料室・分館",
      "隣接自治体や旧郡域の館",
      "専門図書館・資料室(カーリルで見つかる場合)"
    ],
    calilMcp: {
      recommended:
        regionCandidates.length > 0 || specialistLibraryCandidates.length > 0,
      tools: ["search_libraries", "search_books"],
      maxSystems: 15,
      workflow:
        "カーリル MCP の search_libraries で地域名・館種・ネットワーク名・専門資料機関名を検索し、候補の systemid を得る。Web 検索はパスファインダー、新聞/雑誌所蔵一覧、郷土資料ページ、カーリルで見つからない資料室の補助確認に使う。",
      restApiUse: "ISBN既知の所蔵確認のみ。キーワード蔵書検索には使わない。",
      access: buildCalilAccess(input, clientEnvironment)
    },
    specialistLibraryCandidates,
    specialistDiscoveryQueries: buildSpecialistDiscoveryQueries(input),
    searchLibrariesQueries,
    concreteNameDiscoveryQueries: buildConcreteNameDiscoveryQueries(input),
    searchBooksQueries,
    fallbackActions: [
      "地域パスファインダーを確認する",
      "各館 OPAC を直接確認する",
      "新聞所蔵一覧・雑誌所蔵一覧を確認する",
      "レファレンス協同データベースの地域事例を確認する",
      "専門団体・資料室・機関誌/会報の照会先を確認する",
      "図書館レファレンス相談を次アクションに残す"
    ]
  };

  return plan;
}

try {
  const input = readInput();
  process.stdout.write(`${JSON.stringify(buildPlan(input), null, 2)}\n`);
} catch (error) {
  process.stderr.write(`regional library planner input error: ${error.message}\n`);
  process.exitCode = 1;
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall