Source profileQuality 72/100

affaan-m/ECC/docs/ja-JP/skills/scientific-db-pubmed-database/SKILL.md

pubmed-database

Use it for engineering tasks; the detail page covers purpose, installation, and practical steps.

Source repository stars
234,327
Declared platforms
0
Static risk flags
1
Last source update
2026-07-27
Source checked
2026-07-28

Decision brief

What it does—and where it fits

一般的なウェブ検索ではなく PubMed から生物医学文献が必要なタスクにこのスキルを使用します。

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/affaan-m/ECC --skill "docs/ja-JP/skills/scientific-db-pubmed-database"
    Safe inspection promptEditorial

    Inspect the Agent Skill "pubmed-database" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/ja-JP/skills/scientific-db-pubmed-database/SKILL.md at commit 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      使用するタイミング

      MEDLINE または生命科学文献の検索。

      MEDLINE または生命科学文献の検索。MeSH 用語、フィールドタグ、日付、または文献種別を使った PubMed クエリの構築。PMID、アブストラクト、出版メタデータ、または関連引用の検索。
    2. 02

      クエリの構築

      研究質問から始め、概念に分割し、ブール演算子で概念を組み合わせます。

      [ti]: タイトル[ab]: アブストラクト[tiab]: タイトルまたはアブストラクト
    3. 03

      MeSH とサブヘッディング

      概念が安定した統制語彙用語を持つ場合は MeSH を優先します。トピックが新しいまたは用語が多様な場合は MeSH とタイトル/アブストラクト用語を組み合わせます。

      概念が安定した統制語彙用語を持つ場合は MeSH を優先します。トピックが新しいまたは用語が多様な場合は MeSH とタイトル/アブストラクト用語を組み合わせます。正しいサブヘッディング構文では、サブヘッディングをフィールドタグの前に置きます:[majr] は論文の中心的なトピックである必要がある場合にのみ使用します。精度は向上しますが、関連する研究を見逃す可能性があります。
    4. 04

      フィルター

      clinical trial[pt]

      clinical trial[pt]meta-analysis[pt]randomized controlled trial[pt]

    Permission review

    Static risk signals and limitations

    Network access

    medium · line 99

    The documentation includes network, browsing, or remote request actions.

    BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"

    Network access

    medium · line 115

    The documentation includes network, browsing, or remote request actions.

    response = requests.get(f"{BASE}/esearch.fcgi", params=params, timeout=30)

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score72/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars234,327SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    affaan-m/ECC
    Skill path
    docs/ja-JP/skills/scientific-db-pubmed-database/SKILL.md
    Commit
    4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38
    License
    MIT
    Collected
    2026-07-28
    Default branch
    main
    View the original SKILL.md

    PubMed Database

    一般的なウェブ検索ではなく PubMed から生物医学文献が必要なタスクにこのスキルを使用します。

    使用するタイミング

    • MEDLINE または生命科学文献の検索。
    • MeSH 用語、フィールドタグ、日付、または文献種別を使った PubMed クエリの構築。
    • PMID、アブストラクト、出版メタデータ、または関連引用の検索。
    • 再現可能な検索文字列が必要なシステマティックレビューの検索パスの実行。
    • Python、シェル、または別の HTTP クライアントから直接 NCBI E-utilities を使用。

    クエリの構築

    研究質問から始め、概念に分割し、ブール演算子で概念を組み合わせます。

    concept_1 AND concept_2 AND filter
    synonym_a OR synonym_b
    NOT exclusion_term
    

    有用な PubMed フィールドタグ:

    • [ti]: タイトル
    • [ab]: アブストラクト
    • [tiab]: タイトルまたはアブストラクト
    • [au]: 著者
    • [ta]: 雑誌タイトル略語
    • [mh]: MeSH 用語
    • [majr]: 主要 MeSH トピック
    • [pt]: 出版種別
    • [dp]: 出版日
    • [la]: 言語

    例:

    diabetes mellitus[mh] AND treatment[tiab] AND systematic review[pt] AND 2023:2026[dp]
    (metformin[nm] OR insulin[nm]) AND diabetes mellitus, type 2[mh] AND randomized controlled trial[pt]
    smith ja[au] AND cancer[tiab] AND 2026[dp] AND english[la]
    

    MeSH とサブヘッディング

    概念が安定した統制語彙用語を持つ場合は MeSH を優先します。トピックが新しいまたは用語が多様な場合は MeSH とタイトル/アブストラクト用語を組み合わせます。

    正しいサブヘッディング構文では、サブヘッディングをフィールドタグの前に置きます:

    diabetes mellitus, type 2/drug therapy[mh]
    cardiovascular diseases/prevention & control[mh]
    

    [majr] は論文の中心的なトピックである必要がある場合にのみ使用します。精度は向上しますが、関連する研究を見逃す可能性があります。

    フィルター

    出版種別:

    • clinical trial[pt]
    • meta-analysis[pt]
    • randomized controlled trial[pt]
    • review[pt]
    • systematic review[pt]
    • guideline[pt]

    日付フィルター:

    2026[dp]
    2020:2026[dp]
    2026/03/15[dp]
    

    利用可能性フィルター:

    free full text[sb]
    hasabstract[text]
    

    E-utilities ワークフロー

    NCBI E-utilities は再現可能な API ワークフローをサポートします:

    1. esearch.fcgi: 検索して PMID を返す。
    2. esummary.fcgi: 軽量な記事メタデータを返す。
    3. efetch.fcgi: XML、MEDLINE、またはテキストでアブストラクトまたはフルレコードを取得。
    4. elink.fcgi: 関連記事とリンクされたリソースを検索。

    本番スクリプトにはメールアドレスと API キーを使用します。API キーは環境変数に保存し、コミットされたファイルやコマンド履歴には絶対に入れないでください。

    import os
    import time
    import requests
    
    BASE = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils"
    
    
    def esearch(query: str, retmax: int = 20) -> list[str]:
        params = {
            "db": "pubmed",
            "term": query,
            "retmode": "json",
            "retmax": retmax,
            "tool": "ecc-pubmed-search",
            "email": os.environ.get("NCBI_EMAIL", ""),
        }
        api_key = os.environ.get("NCBI_API_KEY")
        if api_key:
            params["api_key"] = api_key
    
        response = requests.get(f"{BASE}/esearch.fcgi", params=params, timeout=30)
        response.raise_for_status()
        time.sleep(0.35)
        return response.json()["esearchresult"]["idlist"]
    
    
    pmids = esearch("hypertension[mh] AND randomized controlled trial[pt] AND 2024:2026[dp]")
    print(pmids)
    

    バッチの場合、非常に長い PMID リストを URL に渡す代わりに、NCBI ヒストリーサーバーパラメーター(usehistory=yWebEnvquery_key)を優先します。

    出力の記録

    各検索パスについて以下を記録します:

    • 正確な検索文字列
    • 検索したデータベース
    • 検索日
    • 使用したフィルター
    • 結果件数
    • エクスポート形式
    • 手動除外

    例:

    | データベース | 検索日 | クエリ | フィルター | 結果 |
    | --- | --- | --- | --- | ---: |
    | PubMed | 2026-05-11 | `sickle cell disease[mh] AND CRISPR[tiab]` | 2020:2026[dp], English | 42 |
    

    レビューチェックリスト

    • フィールドタグは有効な PubMed タグか?
    • 新しいトピックについて MeSH 用語は自由テキストの同義語とペアになっているか?
    • 日付範囲は明示的で適切か?
    • 検索ログにクエリを再現するのに十分な詳細が含まれているか?
    • API キーは環境から読み込まれているか?
    • HTTP コードは解析前に raise_for_status() を呼び出しているか、または 200 以外のレスポンスを処理しているか?
    • レート制限は守られているか?

    参考文献

    Alternatives

    Compare before choosing