HOME > 電算 > python で twitter メモ

python で twitter メモ

Python (tweepy 利用)を使って、twitter に投稿した、読んだり、過去ログを保管したりするのだ。

（2013年7月 追記：最近 twitter の API が 1.0 が使えなくなり、1.1 を使わなければならなくなった。tweepy の新しいバージョン 2.7 を試したが、API 1.1 に対応しているようだ。ただし、いくらかメソッド名が変更されたりしているように見える。このメモは、従前の twitte API を従前の tweepy で使ったメモだから、古い部分があります）

参考：事前準備については、http://jmillerinc.com/2010/05/31/twitter-from-the-command-line-in-python-using-oauth/ がわかりやすかった。

参考：tweepy については、http://joshthecoder.github.com/tweepy/docs/ を見た。

事前準備

認証方式が OAuth になったが、ようするに「twitter がアプリに ID を発給し、ユーザは特定のアプリだけに対してアカウントへの許可をすることができる。この許可はいつでも取り消すことができる」ということだけわかっていればなんとかなる。（OAuth の仕組みについては、http://tools.ietf.org/html/rfc5849 でいいのかな）

(1) twitter にアプリを登録して、CONSUMER KEY　と　CONSUMER SECRET をもらう。

自分用に複数のスクリプトを書く場合でも、この CONSUMER KYE と CONSUMER SECRET は使いまわせばよいので、登録は一度だけやればよい。この作業はググれば、すぐに親切なスクリーンショットつき解説が見つかるよね。

※多くのウェブアプリは、ユーザをまず twitter の認証画面に導く。そのページで、ユーザがアプリに対して自分のアカウントへアクセス認証したら、twitter はしかるべきページ（callback URL）にユーザを飛ばし返す。この仕組みを実現するためには、アプリ開発者はあらかじめ callback URL を、twitter に教えておく必要がある。これはアプリ登録時に行うか、アプリ登録後に https://dev.twitter.com/apps にアクセスして設定すればよい。一方、このページで試みているように、デスクトップから自分用に使うような場合などでは、認証後にユーザを twitter から特定のウェブページに飛ばしてもらう必要がないので、callback URL を twitter に登録しない。この場合、twitter は認証後のユーザをアプリのページにリダイレクトするかわりに、ユーザに対して秘密の番号を表示してくれる。ユーザはその番号を手動でコピペするなどしてアプリに教え、認証を完了することになる。bot を作るなんてのは、後者で間に合う。

(2) twitter の自分のアカウントにそのアプリからのアクセスを許可する

(1)で登録したアプリに対して、自分の twitter アカウントへのアクセスを許可する。このとき twitter は ACCESS KEY　と　ACCESS SECRET を発行するので、これをアプリに教えてやる。以下、具体的作業を対話的にやってみた様子。（callback URL を使わない例）

※追記：2014年1月14日から、twitter の API へのアクセスが TLS/SSL 接続でないといけないことになった。そこで、以下の手順に少しだけ変更が必要となった。autu= で始まる箇所で、「,secure=True」というところが加えたのは、そのため。

$ python
>>> import tweepy
>>> CONSUMER_KEY = '********************'
>>> CONSUMER_SECRET = '*******************'
>>> #（上二行は、(1)でもらっておいたキーとシークレットを入れる）
>>> auth = tweepy.OAuthHandler(CONSUMER_KEY, CONSUMER_SECRET,secure=True)
>>> auth_url = auth.get_authorization_url()
>>> print 'Please authorize: ' + auth_url
Please authorize: http://twitter.com/oauth/authorize?oauth_token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
>>> #（ここで上に表示された URL をブラウザに張り付けて、このときだけ使う暗唱番号を web ページからゲット）
>>> verifier = raw_input('PIN: ').strip()
PIN: xxxxxxxx 
>>> #（上の PIN: のところで、先程もらった暗唱番号をコピペ）
>>> auth.get_access_token(verifier)
<tweepy.oauth.OAuthToken object at 0x8f9166c>
>>> print "ACCESS_KEY = '%s'" % auth.access_token.key
ACCESS_KEY = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
>>> #（上に表示されたアクセスキーは後々まで使うのでメモしておく）
>>> print "ACCESS_SECRET = '%s'" % auth.access_token.secret
ACCESS_SECRET = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
>>> #（上に表示されたアクセスシークレットは後々まで使うのでメモしておく）

(2)の許可は自分の twitter アカウントから取り消すことができる。その場合は、(2)の手続きをもう一度行って、アクセスキーとアクセスシークレットを再取得する。

あとは以上で手に入れた CONSUMER KEY　と　CONSUMER SECRET と ACCESS KEY　と　ACCESS SECRETを使って作業すればよい。もしこれら 4 つの文字列を紛失したら、https://dev.twitter.com/apps で確認できる。

投稿専用スクリプト

#!/usr/bin/env python
import sys
import tweepy
CONSUMER_KEY = 'xxxxxxxxxxxxxxxx'
CONSUMER_SECRET = 'xxxxxxxxxxxxxxxx'
ACCESS_KEY = 'xxxxxxxxxxxxxxxx'
ACCESS_SECRET = 'xxxxxxxxxxxxxxxx'
mypost = sys.stdin.readline().strip()
if 0==len(mypost):
    exit()
auth = tweepy.OAuthHandler(CONSUMER_KEY, CONSUMER_SECRET, secure=True)
auth.set_access_token(ACCESS_KEY, ACCESS_SECRET)
api = tweepy.API(auth)
api.update_status(mypost)

これをシェルから起動すると、一番目の引数にした文字列を投稿することができる。私は GNOME 環境なので、

alias twip='zenity --text-info --filename=/dev/null --editable | python /pass/to/the/script.py'

というのを、シェル用のエイリアスとして書いておき、なんちゃって GUI にして投稿に使っている。

twikabi

ついでだから、コマンドラインでパイプにかませて使えるしょぼいクライアントを書いてみたよ。（API 1.1 未対応）

twikabi

対話環境で投稿したり、タイムラインを読んだりして遊ぶ

まず、以下を念仏のように最初にやって api オブジェクトを得る。

$ python
>>> import tweepy
>>> import type
>>> CONSUMER_KEY = ''
>>> CONSUMER_SECRET = ''
>>> ACCESS_KEY = ''
>>> ACCESS_SECRET = ''
>>> #（上4行は、すでに発行してもらっているものをコピペ）
>>> auth = tweepy.OAuthHandler(CONSUMER_KEY, CONSUMER_SECRET,secure=True)
>>> auth.set_access_token(ACCESS_KEY, ACCESS_SECRET)
>>> api = tweepy.API(auth, api_root='/1.1')

投稿のテストをしてみる。

>>> api.update_status('test')
<tweepy.models.Status object at 0x90ec66c>

タイムラインを取得。

>>> api.home_timeline()

とやると、最新２０個のホーム・タイムラインの投稿をリストにしたものが得られる（すぐ読めるわけではない）

このリストの要素はそれぞれ

<class 'tweepy.models.Status'>

のインスタンスで、投稿（=ステータス）ひとつひとつに対応する。

これらはそれぞれ以下のような変数を持つ。

（これらは、ドキュメントが見つからないから__dict__ を調べた。なお type の欄は、たまたま調べたオブジェクトに値がなかったものが none になっているから、それは信用できない）

テキストの内容は、text <type 'unicode'> だから、最新（０番目）の投稿本文は、

>>> api.home_timeline()[0].text

で得られる。

上で投稿者名は、author という変数が示していて、それは <class 'tweepy.models.User'> のインスタンスである。そこで、これが持つ変数を調べてみると、

（これらは、ドキュメントが見つからないから__dict__ を調べた。なお type の欄は、たまたま調べたオブジェクトに値がなかったものが none になっているから、それは信用できない）

したがって、最新（０番目）の投稿について、api.home_timeline()[0].author.name で名前、api.home_timeline()[0].author.screen_name でスクリーンネーム（@の後につけるやつ）を知ることができる。

まあ、タイムライン最新の20個を一通り読めるようになった。

では、最新20より前のものをどうやって取得するか。

そのために、まず home_timeline() メソッドに食わせるパラメータを見る。（http://joshthecoder.github.com/tweepy/docs/api.html#timeline-methods）

API.home_timeline([since_id][, max_id][, count][, page])¶
* since_id  この数字より新しい ID のツイートを得る
* max_id  この数字と同じか、より古い ID を持つツイートを得る
* count  得るツイート数
* page  得るページを指定する

つまり、

>>> api.home_timeline(count=30)

とかやると、最新30ツイートが得られる。

だが、これには制限がある。

http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses-home_timeline には May not be greater than 200 と書いてある。

ページングを使えば、もっと前のものを知ることもできる。

>>> api.home_timeline(count=200, page=2)

とやれば、200件ずつ最新から表示した場合の2ページ目、つまり最新から数えて201件から400件目までを得られる。 ただ、このやり方にも制限がある。

http://apiwiki.twitter.com/Things-Every-Developer-Should-Know#6Therearepaginationlimits を見ると、ページとカウントで得られるのは 3200 件までとある。

これは、一度に取得できる件数を指すのではなく、それより古い投稿に、ページとカウントを使ってアクセスすることができないということらしい。（なお、これは API の残りカウント http://apiwiki.twitter.com/Rate-limiting とは別立ての制限である）

tweepy のカーソル機能

tweepy は api.user_timeline メソッドなど 1 ページずつ結果を戻してくるメソッドに、対しカーソルを用意し、ページのことを考えないで済むようにしている。

for p in tweepy.Cursor(api.user_timeline,since_id=10000).items(100):
     print unicode(p.text)

上の例は、自分のツイートを、ID が 1001 のツイートから最新のツイートまでのうちで、新しいほうから自分のツイート 100 件を、順にプリントする。

エラーとレスポンス・コード

http://apiwiki.twitter.com/HTTP-Response-Codes-and-Errors にコード一覧

tweepy でエラーの種類を捕えるには、

    try:
        r = api.get_status(id)
    except tweepy.error.TweepError, e:
        print "error response code: " + str(e.response.status)
        print "error messate: " + str(e.response.reason)

などとやればよい。

「お気に入り」

api.favorites(id=xxxxxxxx, page=xxxxxxx) などとやって、ユーザのお気に入りツイートを取得できる。

——目次——

HOME
├雑文
├写真
├壁紙
├馬鹿
├読書
├語学
│├英語
│└日本語
├電算
├地理
│└白地図
└ブログ