【はじめてのCOTOHA API】昔ばなしを要約してみた

[【Qiita x COTOHA APIプレゼント企画】COTOHA APIで、テキスト解析をしてみよう！](https://zine.qiita.com/event/collaboration-cotoha-api/)　という企画を見つけたので、COTOHA APIの使い方と、実際にCOTOHA APIを使って昔ばなしを要約してみた結果をまとめました。

# COTOHA APIとは
![スクリーンショット 2020-02-13 21.40.35.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154305/fdf574d8-8f21-13f8-e804-19e003cb1073.png)

詳しくは[COTOHA APIについて](https://api.ce-cotoha.com/contents/about.html)を見てください。

# COTOHA APIの使い方


## APIを使うために必要な情報を取得しよう

COTOHA APIを使うには、APIを使うために必要な情報を取得するため、まずアカウントの登録をする必要があります。
[COTOHA APIのサイト](https://api.ce-cotoha.com/contents/index.html)の右上にある「新規登録」ボタンを押すと、メールアドレス登録の画面に遷移します。
メールアドレス登録後に来るメールにあるURLから、アカウント登録を行います。
アカウント登録が終了したら、[ログイン画面](https://api.ce-cotoha.com/login)からログインします。
ログインすると、「for Developers アカウント情報」の表中に「Client ID」と「Client secret」という2つの項目があると思います。
これらがCOTOHA APIを使うために必要な情報です。

## Google ColaboratoryでCOTOHA APIを使おう
> Colaboratory は、完全にクラウドで実行される Jupyter ノートブック環境です。設定不要で、無料でご利用になれます。
Colaboratory を使用すると、コードの記述と実行、解析の保存や共有、強力なコンピューティング リソースへのアクセスなどをブラウザからすべて無料で行えます。

[Google Colaboratory](https://colab.research.google.com/notebooks/welcome.ipynb?hl=ja)

Google ColaboratoryはGoogleアカウントがあれば使えます。

Google Colaboratoryを開いたら、まずメニューからファイル→ノートブックを新規作成を選択し、新しいノートブックを作成します。
![スクリーンショット 2020-02-15 18.09.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154305/9173a2aa-34c5-1809-d055-6d25f89293a7.png)

次に、[こちらの記事](https://qiita.com/Tommyyyyyyy/items/60f11a36c3a0fa789fd9)からコードをコピペしましょう。

以下の部分のみ、先ほどログインした際に表示された自分の「Client ID」と「Client secret」に置き換えてください。

``` Python
client_id = "クライアントID"
client_secret = "クライアントシークレット"
```

コードをコピペしたら、▷ボタンを押すとコードが実行されます。

![スクリーンショット 2020-02-12 21.38.34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154305/d223c632-12d8-9be4-f94a-cc6ae1007402.png)

コードを追加したい場合は、「＋コード」を押します。

# 昔ばなしの要約
せっかくなので、COTOHA APIのうち要約APIを使って昔ばなしをいろいろ要約してみました。

> 要約APIは、入力として日本語で記述された複数文で構成された文章を受け取り、これを文単位で重要度を算出し、スコアを付与します。そして、入力時に指定された要約文数に応じ、重要文を返します。
本APIはベータ版として提供させていただきます。
https://api.ce-cotoha.com/contents/reference/apireference.html

昔ばなしの本文は以下のサイトからお借りしました。
http://hukumusume.com/douwa/pc/jap/index.html

プログラムコードは以下です。

``` Python
cotoha_call("summary", "むかしむかし、あるところに、おじいさんとおばあさんが住んでいました。〜〜〜")
```

## 桃太郎
「桃太郎さん、桃太郎さん。どちらへおいでになりますか？」
「鬼ヶ島へ、鬼退治に行くのさ」
「それでは、わたしもお供させてください」
「よし、わかった。それでは日本一のキビ団子をやるからついて来い」
こうして犬はキビ団子を一つもらって、桃太郎のお供に加わりました。

## 金太郎
金太郎の友だちは、山の動物たちです。
動物たちの中には、体の大きなクマやウシやウマやシカもいましたが、金太郎にかないません。
「つな引きも、金太郎の勝ち！」
なんとも大変力持ちの金太郎ですが、強いだけでなく、とてもやさしい男の子です。

## 浦島太郎
どうぞ、ゆっくりしていってくださいね」
浦島さんは、竜宮の広間ヘ案内されました。
「そう言えば、乙姫さまは言っていたな。この玉手箱を開けると、『時』が戻ってしまうと。

## 一寸法師
二人には子どもがいなかったので、おじいさんとおばあさんは神さまにお願いしました。
これには、鬼もまいりました。
「わたしの背がのびるように『背出ろ、背出ろ』と、そう言ってふってください」お姫さまは喜んで、打ち出の小づちをふりました。

## 鶴の恩返し
何て良く気のつく優しい娘さんじゃ。
すると娘はまた、機をおり始めました。
「ねえ、おじいさん。

## カチカチ山
「おじいさん、どうしたのです？」
「タヌキが、タヌキのやつが、ばあさんをこんなにして、逃げてしまったんだ」
「ああ、あの悪いタヌキですね。
「タヌキくん。舟をつくったから、海へ釣りに行こう」
「それはいいな。

## 花咲かじいさん
おめえのシロを、わしに貸してくれや」
欲張りじいさんは、シロを無理矢理畑に連れて行きました。
しかし出てくるのは石ころばかりで、宝物は出てきません。
「枯れ木に花を咲かせましょう。

## かぐや姫
えい！・・・うん？これは！」おじいさんがその竹を切ってみると、なんと中には小さな女の子がいたのです。
中でも特に熱心な若者が、五人いました。これ以上のむこさんはない」
お嫁にいくつもりのないかぐやひめは、何とか断ろうと思いましたが、みかどに逆らえば殺されてしまうかもしれません。

## ネズミの嫁入り
わしを隠してしまうからな」
そこで父さんネズミと母さんネズミは、雲のところへ行ってみました。
チューコをお嫁にもらってくれませんか？」
「そりゃうれしいが、風はわしより強いぞ。
「世界一強い壁さん。


# まとめ
何となくですが、要約になっているのではないでしょうか。
要約についてはまだベータ版ということなので、正式版に期待ですね。

[COTOHA API Portal](https://api.ce-cotoha.com/)