/twei

微博命令行工具

Primary LanguageJavaScript

twei

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

环境

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

安装

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

使用最新的开发版本:

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

使用


  nodejs 命令行微博工具
    
  Usage: twei [command]
    
  Command:
    支持的命令包括: 
    authorize, execute, help, 
    comment, follow, followers, unfollow, update, repost,
    status, user, hot, remind

  Example:
    twei remind
    twei timeline
    twei update 雨一直下个不停
    twei update "你好, 世界" -i ../example.png -c 114.169938,22.559385

测试

npm test

access_token

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

示例

  符号说明: 
    微博用户名: {{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 从 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", twei execute statuses.user sheepmaker count=5 page=2 feature=1

自定义

alias 和 shower 是 twei 提供的自定义命令和样式功能.

  • command alias 可以将常用命令改写成较短的命令.
  • 默认的 twei 只提供了有限类型的数据. 通过 shower 则可以自定义内容的显示样式. 自定义的 shower 可以通过 --shower 指定使用. Example: twei timeline --shower base

联系

如果你对 twei 有任何的建议, 可以使用 issue, 或者直接联系 @sheepmaker