twitter-node 技术文档

1. 安装指南

twitter-node 是一个用于创建与 Twitter 流式连接的项目，并将任何传入的状态推送到 tweet 事件的项目。安装twitter-node前，需要确保已经安装了ntest依赖项。

使用 NPM 进行安装：

npm install twitter-node

或者，在 ~/.node_libraries 中创建一个符号链接：

$ ln -s /path/to/twitter-node/lib/twitter-node ~/.node_libraries/twitter-node

2. 项目使用说明

以下是一个使用twitter-node的基本示例：

var TwitterNode = require('twitter-node').TwitterNode
  , util         = require('util');

var twit = new TwitterNode({
  user: 'username', 
  password: 'password',
  host: 'my_proxy.my_company.com',         // 代理服务器名称或 IP 地址
  port: 8080,                               // 代理端口
  track: ['baseball', 'football'],         // 体育相关关键词
  follow: [12345, 67890],                  // 关注这些随机用户
  locations: [-122.75, 36.8, -121.75, 37.8] // 旧金山的推文
});

// 添加到上面的 track 数组中
twit.track('foosball');

// 添加到上面的关注数组中
twit.follow(2345);

// 关注纽约的推文
twit.location(-74, 40, -73, 41);

// 设置查询参数
twit.params['count'] = 100;

// 设置操作方法
twit.action = 'sample'; // 默认为 'filter'

// 设置请求头
twit.headers['User-Agent'] = 'whatever';

// 监听错误
twit.addListener('error', function(error) {
  console.log(error.message);
});

twit
  .addListener('tweet', function(tweet) {
    util.puts("@" + tweet.user.screen_name + ": " + tweet.text);
  })
  .addListener('limit', function(limit) {
    util.puts("LIMIT: " + util.inspect(limit));
  })
  .addListener('delete', function(del) {
    util.puts("DELETE: " + util.inspect(del));
  })
  .addListener('end', function(resp) {
    util.puts("wave goodbye... " + resp.statusCode);
  })
  .stream();

// 动态添加跟踪内容
twit.track('#nowplaying');
twit.follow(1234);

// 重置流
twit.stream();

3. 项目API使用文档

twitter-node 支持以下事件：

• tweet(json): 当接收到新推文时触发，参数为一个解析后的 JSON 对象。
• limit(json): 当接收到新的限制命令时触发，参数为一个解析后的 JSON 对象。
• delete(json): 当接收到新的删除命令时触发，参数为一个解析后的 JSON 对象。
• end(response): 当 HTTP 连接关闭时触发，参数为 HTTP 响应对象。

更多关于限制和删除命令的示例，请参考 Twitter 流式 API 文档。

4. 项目安装方式

请参考本文档的“安装指南”部分。