opensearch

機械で検索しやすいようにOpenSearchによるAPIを提供します。OpenSearchの APIはOpenSearch API 1.1に準拠しています。HTMLのページで検索するのと同じように、いくつかのフィールドパラメータを組み合わせて検索可能です。以下の検索質問と応答のフォーマットについての記述を参照してください。
OpenSearchを利用される際は、こちらから、WebAPIキーの登録をお願いたします。
現在、本機能はWebAPIキー無しで自由にアクセス可能となっておりますが、将来的にAPIキーでのアクセス制限や新機能等が追加された際に、登録されたメールアドレスにお知らせいたします。

テンプレートを示します。

http://rns.nii.ac.jp/opensearch?q{field}={searchTerms}&start={startIndex?}&count={count?}&sort={sortOrder?}

*SearchTermsは、UTF-8でURLエンコードされている必要があります。

フィールドパラメータ番号と検索対象フィールドの対応

q0	すべてのフィールドを対象とする検索
q1	研究者名による検索
q2	所属機関による検索
q3	所属部局による検索
q4	職名による検索
q5	科研費研究者番号による検索
q6	研究者リゾルバーIDによる検索
q7	科研費研究課題の研究キーワードによる検索
q8	科研費研究課題の研究分野による検索

それぞれのフィールドパラメータでの検索仕様

共通	【AND】【OR】【NOT】(それぞれ大文字のみ)、カッコ【()】を用いた論理演算が可能です。同フィールド内に単語や文字を空白で並べた場合、OR検索になります。【渡辺】【渡邊】【渡邉】等の異体字は、同じ文字として検索されます。ワイルドカード【*】による前方一致、後方一致検索ができます。単独ワイルドカードにより、全検索ができます。ダブルクォート【"】によるフレーズ検索ができます。
q0	フィールドごとの仕様は単独フィールドと同じです。
q1	デフォルトでの検索は、空白無の姓名、性のみ、名のみの3つを対象とした完全一致検索です。
q5,6	デフォルトでの検索は、3ケタ以上の部分一致検索です。スラッシュ【/】で囲んだ数字で完全一致検索ができます。
その他	デフォルトでの検索は、英数字は単語単位、日本語は1文字以上での部分一致検索です。スラッシュ【/】で囲んだ語句で完全一致検索ができます。(スペースは含められません)

ソート順について

パラメータ(sortOrder)	ソート順
0	研究者名カナ昇順
1	研究者名カナ降順
2	研究者名ローマ字昇順
3	研究者名ローマ字降順
4	研究者名漢字コード昇順
5	研究者名漢字コード降順
6	スコア順
指定無	フィールドパラメータがq7,q8 → スコア順その他 → 研究者名カナ昇順

検索質問例

Example 1)

研究者名 "Takeda"で、最初の検索結果のアイテムから20アイテムごとに結果を得たいとき、URLは;
http://rns.nii.ac.jp/opensearch?q1=Takeda&start=1&count=20

Example 2)

研究者名 "武田"で、最初の検索結果のアイテムから20アイテムごとに結果を得たいとき、URLは;
http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=20

Example 3)

研究者名 "Takeda"で、ソート順をローマ字昇順として、最初の検索結果のアイテムから20アイテムごとに結果を得たいとき、URLは;
http://rns.nii.ac.jp/opensearch?q1=Takeda&start=1&count=20&sort=2

次のような検索質問をOpenSearchフォーマットで送信したとき、

http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&start=1&count=3

以下に示すようなXMLによる応答をRSS1.0のフォーマットで得ることができます。

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
    xmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:content="http://purl.org/rss/1.0/modules/content/"
    xmlns:atom="http://www.w3.org/2005/Atom"
    xmlns:owl="http://www.w3.org/2002/07/owl#"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:rns="http://rns.nii.ac.jp/ns#"
    xmlns:kaken="http://kaken.nii.ac.jp/ns#"
    xmlns="http://purl.org/rss/1.0/"
    xmlns:rnsos="http://rns.nii.ac.jp/opensearchextentions#"
  >
  	<channel rdf:about="http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&amp;start=1&amp;count=3">
		<title>Researcher Name Resolver OpenSearch</title>
		<link>http://rns.nii.ac.jp</link>
        <description>Researcher Name Resolver OpenSearch provides search resuts of researchers in Japan.</description>
        <image rdf:resource="http://rns.nii.ac.jp/images/icon/favicon.ico"/>
		<items>
			<rdf:Seq>
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000060256782" />
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000020020589" />
				<rdf:li rdf:resource="http://rns.nii.ac.jp/nr/1000080186189" />
			</rdf:Seq>
		</items>
        <atom:link atom:type="application/opensearchdescription+xml" atom:href="http://rns.nii.ac.jp/description.xml" atom:rel="search"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?q0=%E6%AD%A6%E7%94%B0&amp;start=1&amp;count=3" atom:rel="self"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=1&amp;count=3&amp;q0=%E6%AD%A6%E7%94%B0" atom:rel="first"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=4&amp;count=3&amp;q0=%E6%AD%A6%E7%94%B0" atom:rel="next"/>
        <atom:link atom:type="application/rss+xml" atom:href="http://rns.nii.ac.jp/opensearch?start=355&amp;count=3&amp;q0=%E6%AD%A6%E7%94%B0" atom:rel="last"/>
        <dc:publisher>National Institute of Informatics</dc:publisher>
		<dc:date>2011-10-13T19:39:16+09:00</dc:date>
		<opensearch:totalResults>357</opensearch:totalResults>
		<opensearch:startIndex>1</opensearch:startIndex>
		<opensearch:itemsPerPage>3</opensearch:itemsPerPage>
        <opensearch:Query opensearch:searchTerms="武田" rnsos:format="rss1.0" rnsos:sortType="0" opensearch:startIndex="1" opensearch:role="request"/>
	</channel>
    <image rdf:about="http://rns.nii.ac.jp/images/icon/favicon.ico">
        <title>Researcher Name Resolver</title>
        <url>http://rns.nii.ac.jp/images/icon/favicon.ico</url>
        <link>http://rns.nii.ac.jp/</link>
    </image>
<item rdf:about="http://rns.nii.ac.jp/nr/1000060256782">
    <title>Researcher Name Resolver - 長田 真紀(1000060256782)</title>
    <link>http://rns.nii.ac.jp/nr/1000060256782</link>
    <content:encoded>
        <dt><a href="http://rns.nii.ac.jp/nr/1000060256782">長田 真紀</a> オサダ マキ - ID:1000060256782</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>60256782</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>上田女子短期大学/講師</dd>
                <dt>Research Field (From KAKEN)</dt><dd>国文学</dd>
                <dt>Keywords (From KAKEN)</dt><dd>山下現有/渡邊海旭/僧侶の妻帯/浄土宗/武田泰淳/仏教/武田芳淳</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000060256782</dd>
            </dl>
        </dd>
    </content:encoded>
</item>
<item rdf:about="http://rns.nii.ac.jp/nr/1000020020589">
    <title>Researcher Name Resolver - Takeuchi, Makoto | 竹内 誠(1000020020589)</title>
    <link>http://rns.nii.ac.jp/nr/1000020020589</link>
    <content:encoded>
        <dt><a href="http://rns.nii.ac.jp/nr/1000020020589">竹内 誠</a> タケウチ マコト Takeuchi, Makoto - ID:1000020020589</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>20020589</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>東京学芸大学/教育学部/教授</dd>
                <dt>Research Field (From KAKEN)</dt><dd>日本史</dd>
                <dt>Keywords (From KAKEN)</dt><dd>江戸城/浅草/甲府/町場/後北条氏/戦国大名/品川/城下町/東国/八王子/商業/港湾/流通/江戸/考古学発掘/武田氏/小田原/関東/都市/川越/市/東国都市/商品作物</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000020020589</dd>
            </dl>
        </dd>
    </content:encoded>
</item>
<item rdf:about="http://rns.nii.ac.jp/nr/1000080186189">
    <title>Researcher Name Resolver - Kikuta, Toshiro | 菊田 紀郎(1000080186189)</title>
    <link>http://rns.nii.ac.jp/nr/1000080186189</link>
    <content:encoded>
        <dt><a href="http://rns.nii.ac.jp/nr/1000080186189">菊田 紀郎</a> キクタ トシロウ Kikuta, Toshiro - ID:1000080186189</dt>
        <dd>
            <dl>
            	<dt>KAKENHI Researcher Number</dt><dd>80186189</dt>
                <dt>Latest Affiliation(From KAKEN)</dt><dd>山形県立米沢女子短期大学/助教授</dd>
                <dt>Research Field (From KAKEN)</dt><dd>国語学</dd>
                <dt>Keywords (From KAKEN)</dt><dd>御軍列配置とメルクマ-ル/武士ことば/索引化/表音式と表意式の混合/書誌的研究/武士階級の日常語/漢語の転義/身体語彙の表記と配属部首/「武田晴信悪行之事」願文考証/宗教色のこい用語/「茶入」の命名法/位相語/字体類似による誤字の例/識字史/森平右衛門</dd>
                <dt>URI</dt><dd>http://rns.nii.ac.jp/nr/1000080186189</dd>
            </dl>
        </dd>
    </content:encoded>
</item>
</rdf:RDF>

XMLの応答フォーマットで利用されるタグは以下のようです。

channel	チャンネル記述(RSS1.0)
rdf:about	このチャンネルリソースのURI
title	チャンネルの記述的タイトル。 "Researcher Name Resolver OpenSearch"
link	このサービスのURL
items	アイテムを含んだ検索結果リスト
rdf:seq	シーケンスリスト
rdf:li	リスト中のアイテム
atom:link atom:rel="self"	結果セットの現在ページのURL
atom:link atom:rel="first"	結果セットの最初のページのURL
atom:link atom:rel="next"	結果セットの次ページのURL
atom:link atom:rel="last"	結果セットの最後のページのURL
item	アイテムの記述
rdf:about	このアイテムリソースのURI
title	このアイテムの記述的タイトル "Researcher Name Resolver - $researcherName (Researcher Name Resolver ID)"
link	研究者URIへのリンク。このリソースのURIと同じです。
content:encoded	このアイテムのHTMLによる記述。RSSリーダー上で表示されるようになっています。

研究者のURIにアクセスするには、次のヘルプドキュメントをご覧ください。

OpenSearchによるデータベース検索

概要

OpenSearchによる検索質問フォーマット

フィールドパラメータ番号と検索対象フィールドの対応

それぞれのフィールドパラメータでの検索仕様

ソート順について

検索質問例

Example 1)

Example 2)

Example 3)

結果集合を得る応答フォーマット

研究者リゾルバーについて

ウェブサービス

問い合わせ先