ManifoldCFを使って、Webのニュース記事をローカルファイルに落とす

##はじめに
Watson Discoveryには専用のクローラがあるのですが、現在のところ残念ながらWEBサイトをクロールする機能を持っていません。
そこで、別ソフトを使いいったんWebコンテンツをクロールした結果をローカルファイルに落とし、その結果をDiscovery付属のクローラでDiscoveryに取り込むということを実際に試してみました。
クローラは何を使ってもよかったのですが、ApacheのOSSであるManifoldCFが一番、イマ風かと思い、これを使ってみました。わかりやすい資料があまりなく、最初どう使っていいかわからず戸惑ったのですが、仕組みを理解できるとすごくよくできていることがわかり、今ではとても気に入っています。
その手順をこれから簡単に説明しようと思います。

##前提OS
Mac OS High Sierraです。
この作業中に勝手に?バージョンアップされて、OSバージョンは作業終了時には10.13.2になっていました。

##ソフトのダウンロード、解凍、起動
以下の手順で行いました。
Javaのバージョンが 9.0.1の場合、以下の手順で簡単に立ち上げることができました。

```
$ wget http://ftp.jaist.ac.jp/pub/apache/manifoldcf/apache-manifoldcf-2.9/apache-manifoldcf-2.9-bin.tar.gz
$ tar xzvf apache-manifoldcf-2.9-bin.tar.gz
$ cd apache-manifoldcf-2.9
$ cd example
$ java -jar start.jar
```

##管理画面の起動、ログイン
上のコマンドでstart.jarが正常に立ち上がった場合
```
http://0.0.0.0:8345/mcf-crawler-ui/login.jsp
```
で、下記のログイン画面が表示されるはずなので、**admin/admin**の**ユーザーID/パスワード**でログインします。
一点注意しないといけないのが、利用するブラウザです。いつものクセでSafariを使っていたのですが、これだと更新系のタスクが一切まともに動きません。(これで結構時間を無駄にしました。。)
Firefoxを使う必要があるみたいなので、この点に注意してください。

![スクリーンショット 2018-01-15 14.49.44.png](https://qiita-image-store.s3.amazonaws.com/0/206130/b4599beb-be10-0e86-d2e7-3cfba27d9217.png)


ログインすると、以下のような画面が表示されます。

![スクリーンショット 2018-01-15 10.05.29.png](https://qiita-image-store.s3.amazonaws.com/0/206130/309b5255-de0d-988d-fd6c-ac2f0ac1adb1.png)

今回の目的を最短コースで実現するには、

* 出力の定義
* リポジトリの定義
* ジョブの定義
* ジョブの実行

という手順になります。

考え方として、

**出力**: 出力先の種別の定義
**リポジトリ**: 入力の種別の定義
**ジョブ**: 複製の個別タスク

ということになります。
上２つは、抽象的なクラス定義のようなものです。
ジョブが具体的なインスタンスにあたります。

今回のユースケースだと、

**出力**: ファイルシステム
**リポジトリ**: WEBサイト
**ジョブ**: 入力はWEB、出力はファイルシステム。xxxのサイトをクロールし、その結果を /xxx/yyy ファイルシステムに保存する

みたいな感じです。
以下でではそれぞれの設定例について説明しますが、上のことを念頭においておくと、個々の作業の理解が早いと思います。

##出力コネクションの定義

出力コネクションとは、クロールした情報の出力先のことです。
Solr / Elasticsearchへの取込みが目的の場合、それぞれ用のConnectorがあるので、それを選べばいいのですが、Watson Discoveryではまだそのようなコネクタがないので、いったんローカルのファイルシステムに落とすことにします、
左側のメニューから「出力コネクション一覧」を選択し、「新しい出力コネクションを追加」をクリックし、次の画面では"fs_conn"などの名前を入力

![スクリーンショット 2018-01-15 13.05.44.png](https://qiita-image-store.s3.amazonaws.com/0/206130/088ec6eb-4662-06c1-3425-3edc880800a8.png)

「タイプ」のタブを選択し、ドロップダウンから"File system"を選択し、下の画面になるので「次へ」を選択。更に「保存」をクリック。


![スクリーンショット 2018-01-15 13.08.59.png](https://qiita-image-store.s3.amazonaws.com/0/206130/bf95fdbe-8181-866c-feb9-ecb4f16d1c8e.png)

![スクリーンショット 2018-01-15 13.09.09.png](https://qiita-image-store.s3.amazonaws.com/0/206130/8dc890bf-de1f-c8b3-f9e3-966ec8f59da5.png)

これで出力コネクションの定義ができたので、次にリポジトリの定義を行います。

##リポジトリの定義

リポジトリとは、読込元のデータソースのことです。
今回はWebを選択しますが、ManifoldCFではこの他にも多くのリポジトリを対象とすることができます。

左側のメニューから「リポジトリコネクション一覧」を選択し、「新しいコネクションを追加」のボタンをクリックします。
下のような画面がでてくるので、web_connなど適当な名前を指定し、「タイプ」タブをクリック。

![スクリーンショット 2018-01-15 13.09.55.png](https://qiita-image-store.s3.amazonaws.com/0/206130/362caa97-1e2f-8919-18c3-7d4f3ea9159f.png)

次の画面が出てきたら、コネクションタイプに"Web"を選択します。権限グループはデフォルトのままで「次へ」

![スクリーンショット 2018-01-15 13.10.09.png](https://qiita-image-store.s3.amazonaws.com/0/206130/aa69c33f-5616-bb52-b3d5-7d716c218152.png)

次の画面になったら「メール」のタブを選択し、emailアドレスを入力します。

![スクリーンショット 2018-01-15 13.10.21.png](https://qiita-image-store.s3.amazonaws.com/0/206130/2b7e1178-ab52-f36f-fcaf-1ef790d30103.png)

クロール先にSSLがある場合は、「証明証(ママ)」タブをクリックしてください。
(日本語がちょっと変です。。)
図のようにURL正規表現を https://*　として、「すべてを信用する」にチェックを付けてください。(一番緩い設定の場合)

![スクリーンショット 2018-01-15 13.11.23.png](https://qiita-image-store.s3.amazonaws.com/0/206130/12580b68-0216-55bd-a25b-9d73a2274434.png)

入力した後で「追加」ボタンを押すと、下の図のようになります。

![スクリーンショット 2018-01-15 13.12.14.png](https://qiita-image-store.s3.amazonaws.com/0/206130/0f5340c8-fece-8461-bc4c-90e078ba981f.png)

必要な情報を全部入力したら、「保存」ボタンをクリックして保存します。これでリポジトリの定義は終わりです。次にジョブの定義を行います。

## ジョブの定義

例によって、メニューから「ジョブ一覧」を選択し、「新しいジョブを追加」をクリックします。下の画面がでたら、"nikkei_site_crawl"　などの適当な名前を入力し、「コネクション」タブをクリックします。

![スクリーンショット 2018-01-15 13.13.16.png](https://qiita-image-store.s3.amazonaws.com/0/206130/1c8669ef-362a-318d-b055-f5c9411878ea.png)

「コネクション」タブを押した直後は、下のような画面になっています。ここでまず入力(=リポジトリ)を指定します。右の接続名の欄に、先ほど定義したリポジトリの名前がドロップダウンにでてくるはずなので、それを指定します。その後で画面下方の「次へ」ボタンをクリックします。

![スクリーンショット 2018-01-15 13.14.16.png](https://qiita-image-store.s3.amazonaws.com/0/206130/f68e813d-a87e-b813-0073-fd1ec5a96972.png)

次は出力の指定です。2行目の接続名の欄には、一番最初に出力の定義で定義した名前がでてくるはずなので、それを選択し、「出力を追加」ボタンをクリックします。

![スクリーンショット 2018-01-15 13.15.10.png](https://qiita-image-store.s3.amazonaws.com/0/206130/3050f3f4-c4ed-5d58-f68e-54af73656ae0.png)

すると、下の図のようにリポジトリと出力の２行の内容が確定した状態で表示されます。

![スクリーンショット 2018-01-15 13.15.53.png](https://qiita-image-store.s3.amazonaws.com/0/206130/7e9b8ed5-cf06-ed2e-16f8-60f9979947ca.png)

後は、他のタブをクリックして必要なパラメータを定義していきます。
最初に設定が必要なのが「シード」タブです。

下記が「シード」タブをクリックした直後の画面です。
ここではWEBクロールをかけるための起点となるWEBページのURLを指定します。
(通常はサイトのトップページ)

![スクリーンショット 2018-01-15 14.33.23.png](https://qiita-image-store.s3.amazonaws.com/0/206130/5a4f9135-1908-7de4-c25b-214467d5fac7.png)

ちなみに、図ではhttpsの検証もかねて日経のサイト( https://www.nikkei.com/ )にしていますが、ここでは有料ページばかりで意味のある情報はほとんど取れませんでした。それよりはライブドアニュースのURL( http://news.livedoor.com/ )をお勧めします。。
WEBクロールの際に意識する必要のあるタブとして以下のようなものがあります。

- **含む** WEBクロールではseedsで指定されたURLを出発点に、そのページに書かれているURL情報を抜いてきいて、新たにそのページをクロールし、ということを繰り返すわけですが、その際、どの範囲までをクロール対象とするのかの定義です。今回はseedsと同じ "https://www.nikkei.com/*."  としました。

![スクリーンショット 2018-01-15 13.17.32.png](https://qiita-image-store.s3.amazonaws.com/0/206130/c6fe853b-60f2-9398-2a3a-d34e77f9aa3d.png)

- **除外** Includesと逆に除外したいサイトがあればそれを指定します。今回は特に指定しませんでした。
 
一番右の**「出力パス」**タブは、どのディレクトリにクロール結果を書き出すかを指定します。
今回のユースケースの場合、必須の設定項目です。ダウンロード用の適当なパスを指定します。最後に「保存」ボタンを押して設定を保存します。
以上で(今回のユースケースに限っていえば)必要は設定は完了です。あとは、今設定したジョブを実行するだけとなります。

![スクリーンショット 2018-01-15 14.38.28.png](https://qiita-image-store.s3.amazonaws.com/0/206130/8f35b8b8-44f6-1241-14c8-57514940b021.png)

##ジョブの実行
最後に今定義したジョブを実行します。
ジョブの実行は左のメニューのうち「ジョブ」「ジョブの状態と管理」を選択して行います。
下記のようなメニューが出るので。今定義したジョブに対して「開始」ボタンを押します。

![スクリーンショット 2018-01-15 13.20.43.png](https://qiita-image-store.s3.amazonaws.com/0/206130/ede4b215-2392-494e-09f9-182c1cb299b6.png)

下記にジョブ実行中の途中経過の画面を示します。seedから出発して処理対象のコンテンツ数が増え、少し遅れて「処理済み」のコンテンツ件数も増えている様子がわかると思います。

![スクリーンショット 2018-01-15 13.30.54.png](https://qiita-image-store.s3.amazonaws.com/0/206130/72510f92-675d-6a96-b215-a1bef8fcef26.png)

![スクリーンショット 2018-01-15 14.44.15.png](https://qiita-image-store.s3.amazonaws.com/0/206130/9e90dc06-4152-0607-5911-546cb0fa1a4b.png)

##おまけ
ここでダウンロードして得られたニュース記事をDiscovery付属のクローラを使ってDiscoveyに取り込むための手順については、別記事[付属クローラツールを使ってファイルシステム上のコンテンツをWatson Discoveryに取り込む](https://qiita.com/makaishi2/items/4342130435e85f10b514)を参照してください。