Twei NPM | npm.io

twei

twei 是用 node.js 编写的微博命令行工具. 目前支持新浪微博的查看与发送.

环境

twei 适用于所有可运行 node.js 的环境, 包括 windows, linux, mac os, cygwin 等.

安装

安装 node.js
在命令行中: npm install -g twei
twei --version

使用最新的开发版本:

git clone https://github.com/justan/twei.git
cd twei && npm link
twei --version

使用

  符号说明: 
    微博用户名: {{username}}
    微博 id: {{sid}}
    微博评论 id: {{cid}}
    评论内容: {{comment}}
    微博内容: {{status}}

查看提醒: twei remind
更新微博
- 发微博: twei update 雨一直下个不停
- 发带网络图片的微博: twei update 雨一直下个不停 -i http://example/example.png
- 发带本地图片的微博: twei update 雨一直下个不停 -i ./example.png
- 转发微博: twei repost {{sid}} {{status}}
- 转发并评论: twei rt {{sid}} {{status}}
timeline
- 查看收到的微博: twei timeline
- 查看自己的微博: twei timeline.user
- 查看指定用户的微博: twei timeline.user {{username}}
- 查看@你的微博: twei timeline.mentions
查看用户信息: twei user {{username}}
查看指定用户的粉丝: twei followers {{username}}
查看 follow 哪些人: twei friends {{username}}
follow 某人: twei follow {{username}}
评论
- 查看@你的评论: twei comments.mentions
- 查看你发出评论: twei comments.by_me
- 查看给你的评论: twei comments.to_me
- 查看某条微博的评论: twei comments {{sid}}
- 评论微博: twei comment {{sid}} {{comment}}
- 删除评论: twei comment.remove {{sid}}
- 回复评论: twei comment.reply {{sid}} {{cid}} {{comment}}
帮助
- 查看 execute 的帮助内容: twei help execute or twei execute -h
- 查看新浪微博 api 文档:
  - twei help remind
  - twei help timeline
  - twei help whois

进阶使用

通过管道 twei 可以方便的借用 *nix 其他字符处理程序(诸如: grep xargs cut 等)的强大功能. 如:

用 less 查看微博列表: twei timeline --count 100 | less -R
查看未读微博: twei remind --filter status | xargs twei timeline --count
unfollow 你关注列表中没有 follow 你的人: twei friends {{username}} --filter users.follow_me users.name | grep false | cut -f 2 | xargs -i twei unfollow {}如果你知道有意思的用法, 请告诉我 :)

测试

npm test

access_token

由于新浪的 api 限制, 目前的 access_token 只有数天的有效期. Access_token 过期后需要输入你重新授权后的新 access_token.

access_token保存在$HOME/.tweirc:

[tsina]
2 access_token = 2.00V_123567abcdefg

由twei发布的微博会显示来自twei，如果你希望将twei改成你在新浪微博申请的应用的名称，只需用你的应用的access_token替换即可。你可以在微博API测试后台看到access_token。

自动补全

twei 从 v0.2.3 版本后开始支持 bash 和 zsh 的自动补全功能. 该功能默认未开启. 使用方法同 npm : twei completion >> ~/.bashrc or twei completion >> ~/.zshrc

execute

相比上面的示例, twei 提供了功能更为完整的微博命令行接口 execute. 使用 execute 命令可以执行较为完整的微博 api 接口.

Usage: twei execute {{apistr}} {{querystring}}

apistr & querystring:

twei 将新浪微博的接口转接成 group.name 的 apistr 形式. 使用 twei api, 在命令行中即可直接操作微博的接口.

querystring 是 apistr 的请求参数. querystring 可以是普通的请求字符串格式(uid=1488292340), 如果该条 api 定义了expect, querysting 可以省去请求参数头部分(前例中的 "uid=" 部分). 完整的 querysting 请参考新浪微博的接口

Usage: twei timeline.home count=2 page=2 or twei timeline.home "count=2&page=2" or twei timeline --count 2 --page 2, twei execute statuses.user sheepmaker count=5 page=2 feature=1