アドバンスト・サーチのクエリ構文
このページでは、TCSEのアドバンスト・サーチで使えるクエリ構文を説明します。すべてのアノテーションは spaCy 3.8（en_core_web_lg）によって生成されています。
記法
| 目的 | 記法 | 例 |
|---|---|---|
| レンマ（基本形） | [LEMMA] |
[be], [help] |
| 品詞 | {POS} |
{n}, {v}, {adj} |
| 表層形 + 品詞 | SURFACE{POS}（スペースなし） |
help{v}, help{-v} |
| レンマ + 品詞 | [LEMMA]{POS}（スペースなし） |
[help]{n}, [be]{v} |
| 否定品詞 | {-POS} |
help{-v}（動詞でない help） |
| 依存関係 / タグ | {@DEP} |
{@nsubj}, {@auxpass} |
| 形態素情報 | {#MORPH} |
{#past}, {#mod} |
| 固有表現 | %ENTITY |
%PERSON, %ORG, %GPE |
| 論理和（OR） | A|B |
[news|paper|article] |
| AND条件（否定） | A&B |
-word1&word2 |
| セグメント先頭 | ^ |
^ having {v} |
| 否定マッチ | -WORD |
-rid |
| 前方一致 | +PREFIX |
+un {adj} |
| リテラル表層形 | ['SURFACE'] |
['s] |
| 名詞チャンク | _ |
[give] _ _ |
| 型付き名詞チャンク | _{COND} |
[give] _{pron} _ |
| ワイルドカード（1語） | -_ または {} |
to -_ surprise |
| ワイルドカード（0語以上） | * |
to * surprise |
ワイルドカード: _ vs -_ vs *
| 記法 | マッチ対象 | 使用例 |
|---|---|---|
_ |
1つの名詞チャンク（複数語にまたがる場合あり） | [give] _ _ は "give the students a chance" にマッチ |
-_（または {}） |
任意の1語 | to -_ surprise は "to my surprise", "to our surprise" にマッチ |
* |
0語以上の任意の語（貪欲マッチ） | to * surprise は "to his great surprise" にマッチ |
型付き名詞チャンク: _{COND}
v13.1.0（2026年8月）で追加。_ は任意の名詞チャンクにマッチしますが、_{COND} はチャンクの主要部（root トークン）に条件を付けられます。条件部は通常のトークンに使う {...} と同じミニ言語です。
| クエリ | マッチ対象 |
|---|---|
_{pron} |
代名詞を主要部とする名詞チャンク（me, them など） |
_{noun|propn} |
普通名詞または固有名詞が主要部のチャンク |
_{-pron} |
補集合：代名詞主要部でないすべての名詞チャンク |
_{@nsubj} |
主要部が nsubj 依存関係を持つチャンク |
_{%PERSON} |
PERSON エンティティを主要部とするチャンク（v13.2.0以降） |
_{[life]} |
root のレンマが life のチャンク（v13.5.0以降） |
_{[part|role]} |
root のレンマが part または role のチャンク（v13.6.0以降） |
- 1文字エイリアス（
_{v},_{n},_{pr}など）も使えます。ただし{a}は避けてください。単独では副詞（adv）に解決されますが、|や&を含む複合条件の中では形容詞（adj）に解決されます。{adj}・{adv}を明示的に書くのが確実です |（OR）・&（AND）・-（否定）を組み合わせられます_{X}と_{-X}は素の_のマッチを厳密に二分割するため、補集合を使った網羅的な分類が可能です- v13.5.0 からは、チャンク条件でroot のレンマを直接指定できます。
_{[life]}はレンマ life を主要部とするチャンク（a life・the lives we lead）にマッチします。他の条件との合成（_{[life]&noun}）や否定（_{-[life]}）も可能です。例えば[live]{verb} _{[life]}は同族目的語のペアを直接回収します。v13.6.0 からはレンマ条件に選択肢も書けます。_{[part|role]}はどちらかのレンマを主要部とするチャンクに、_{-[part|role]}はどちらでもないチャンクにマッチします - 種類の異なる条件は論理和の中で自由に混ぜられます。
_{pron|%PERSON}は「代名詞主要部または PERSON エンティティのチャンク」にマッチし、「人である指示対象」を表す実用的な書き方です - v13.2.0（2026年8月）から固有表現型も使えます。
_{%PERSON}は主要部トークンが PERSON エンティティに属するチャンクにマッチし、|で型を組み合わせられます（_{%PERSON|%ORG}）。補集合_{-%PERSON}は、主要部がエンティティでないチャンクも含みます。未知の型名はエラーになります
例：[give|send|tell|show|offer] _{pron} _ は受領者が代名詞の二重目的語構文を検索します。_{pron} を _{-pron} に替えるとそれ以外のすべてが得られます。
レンマ照応: :N と =N
v13.3.0（2026年8月）で追加。スロットの条件に :N を付けると、そのスロットがマッチした語のレンマを束縛できます（{verb:1}・[dream]{verb:1}）。後続の名詞チャンク条件で =N と書くと、root のレンマが同じチャンクにマッチします。
| クエリ | マッチ対象 |
|---|---|
{noun:1} [after] _{=1} |
N-after-N 型の重語: study after study, year after year |
[dream]{verb:1} * _{=1} |
同族目的語: dream a dream |
... _{=1&@dobj} |
照応は他のチャンク条件と組み合わせ可能 |
:Nは通常のトークン条件（{verb:1}）にもレンマスロット（[dream]{verb:1}）にも付けられます- v13.4.0 からは、通常のトークン条件の中でも
=Nを使えます。{adv:1} [and] {=1&adv}は反復副詞のペア（over and over・again and again）を回収します =Nはクエリ中でそれより前に束縛されたスロットを参照する必要があります。未束縛・前方参照、同じNの重複束縛、否定形（-=N）はクエリエラーになります
品詞タグ
クエリで使用される主な品詞タグ（大文字・小文字は区別しません）。すべての品詞タグ、Fine-Grainedタグ、依存関係ラベル、形態素性の完全なリストは言語アノテーション リファレンスを参照してください。
| タグ | 意味 | タグ | 意味 |
|---|---|---|---|
{n} |
名詞 | {v} |
動詞 |
{adj} |
形容詞 | {adv} |
副詞 |
{p} |
前置詞 | {dt} |
限定詞 |
{pron} / {pr} |
代名詞 | {cconj} / {sconj} |
等位接続詞 / 従位接続詞 |
{num} |
数詞 | {part} |
小辞 |
{intj} |
間投詞 | {aux} |
助動詞 |
Universal POSの代名詞には {pron} または {pr}、Penn Treebankの詳細タグには {@PRP} を使います。これらは別の検索条件で、{prp} は品詞の短縮形ではありません。等位接続詞には {cconj}、従位接続詞には {sconj} を使い、{conj} は品詞の短縮形として使えません。
形態素情報
{#feature} を使って形態素的な特徴で検索できます（形態素アノテーションに対する部分一致検索）：
フル形式の注釈（例: Tense: Past）は空白を含むためクエリには書けません。値だけの略式（{#past}・{#plur}・{#prog}）が正式な書き方です。大文字小文字は区別せず、部分一致です。
| 特徴 | マッチ対象 |
|---|---|
{#past} |
過去時制の形式（Tense: Past） |
{#mod} |
法助動詞（VerbType: Mod） |
{#ger} |
動名詞形（VerbForm: Ger） |
{#plur} |
複数形の名詞・代名詞（Number: Plur） |
受動態について
spaCy の en_core_web_lg モデルは、英語の受動態を形態素情報としてアノテーションしません。受動態の検索には依存関係ラベルを使用してください：{@auxpass}（受動態助動詞）または {@nsubjpass}（受動態主語）。
固有表現検索
%ENTITY 記法で固有表現を検索できます。18種類のエンティティタイプの一覧は固有表現検索を参照してください。
| 例 | マッチ対象 |
|---|---|
%PERSON said |
人名の後に "said" が続くもの |
%ORG |
組織名 |
in %GPE |
"in" の後に国名・都市名が続くもの |
%DATE |
日付表現 |
縮約形の扱い
TCSEのコーパスはspaCyでトークン化されており、縮約形は別々のトークンに分割されます。例えば I'm は I + 'm の2トークンとして格納されています。アドバンスト・サーチでは、入力された縮約形が自動的に分割されるため、自然な表記のまま検索できます。
| 入力 | 解釈 | マッチ対象 |
|---|---|---|
I'm going |
I 'm going |
I'm going to ... |
don't |
do n't |
don't, Don't |
let's |
let 's |
let's, Let's |
Tom's fine |
Tom 's fine |
Tom's fine |
can't [be] |
ca n't [be] |
can't be, can't have been |
縮約形を含む動詞のすべての活用形を検索するには、レンマ記法を使用します：
| 入力 | マッチ対象 |
|---|---|
I [be] |
I am, I'm, I was, I were |
[do] n't |
don't, doesn't, didn't |
I [have] |
I have, I've, I had |
I [will] |
I will, I'll |
's の曖昧性（be、have、所有格のいずれか）を解消するには、品詞フィルタを付加します：
| 入力 | マッチ対象 |
|---|---|
it's |
it's のすべての用法 |
it ['s]{aux} |
it's = it is（be動詞） |
it ['s]{part} |
its 所有格 |
Tom [be] |
Tom is, Tom's（be動詞）, Tom was |
手動で分割済みの入力
すでにスペースで区切って入力した場合（例：I 'm）、二重に分割されることはありません。I'm と I 'm は同じ結果を返します。
使用例
| 例 | マッチする表現 |
|---|---|
[excite] |
excite, excites, excited, exciting |
{n} |
あらゆる名詞（代名詞を除く） |
{v} |
あらゆる動詞 |
to * surprise |
to our surprise, to his surprise 等 |
[read] {dt} [news|paper|article] |
they read these articles, reading the paper 等 |
^ having {v} |
Having started the process, Having said that 等 |
[help]{n} |
an aunt offered financial help, we called people for help 等 |
[help]{v} {p} {v} |
helped us build, help you keep away 等 |
[get] -rid of |
get outside of, get ahead of, got tired of 等 |
help{-v} |
名詞としての help（動詞ではない） |
+un {adj} |
"un" で始まる語の後に形容詞が続くもの |
[give] _ _ |
二重目的語の "give"（名詞チャンク2つ） |
['s] |
リテラル表層形 "'s" |
%PERSON said |
人名が何かを言った文 |
{@auxpass} |
受動態助動詞（was built, been given） |
{@nsubj} [be] |
主語名詞の後に "be" の活用形が続くもの |
{#past} {#past} |
過去時制トークンが2つ連続するもの |