combine-rss v0.0.3

node-combine-rss

combine rss feeds in url

input multiple rss feeds, then output single xml url

combined rss object can deal like below.

##install

using npm:

npm install combine-rss

or using package.json:

"combine-rss": "*"

##example

# Coffeescript

# rss feed urls
apple    = "http://images.apple.com/main/rss/hotnews/hotnews.rss"
livedoor = "http://news.livedoor.com/topics/rss/trend.xml"

# schema
schema = 
  title: "combiner_rss"
  description: "node_rss_combine"
  feed_url: "http://nikezono.net/rss.xml"
  site_url: "http://nikezono.net"
  image_url: "http://nikezono.net/favicon.ico"
  author: "nikezono"

# require
combiner = require('combine-rss').combiner()

# add
combiner.add [apple,livedoor]

# delete
combiner.del livedoor, (urls)->
  console.log urls
  # => ["http://images.apple.com/main/rss/hotnews/hotnews.rss"]

# combine
combiner.combine (rss)->
  console.log rss.articles
    # => combined articles array
  rss.output schema,(xml)->
    console.log xml
    # => xml string

# combine(async)
combiner.combine()
setTimeout ->
  rss = combiner.rss()
  rss.output schema,(xml)->
    console.log xml
    # => xml string
,500

#crawl(alias)
combiner.crawl (rss)->
  rss.output schema,(xml)->
    console.log xml
    # => xml string
  console.log rss.articles
    # => combined articles array

API

Combiner

combiner.add(feed_url,callback)

add feed url to instance property. #####Arguments

• feed_url - either String and Array type argument is possible.
• callback(urls) - Optional. This function gets urls Array containing all added urls.

combiner.del(feed_url,callback)

delete feed url in instance property. #####Arguments

• feed_url - either String and Array type argument is possible.
• callback(urls) - Optional. This function gets urls Array containing all added urls.

combiner.deleteAll()

delete all url in instance property.

combiner.geturls()

Return urls Array containing all added urls.

combiner.combine(callback)

combine all urls to single rss object. #####Arguments

• callback(rss) - Optional. This function gets rss object which combined all added urls.

combiner.rss()

Return RSS objects.

combiner.crawl(callback)

alias to combine().

RSS

rss.articles

Return rss Object Array sorted by PubDate and descending order. each object is parsed by node-parse-rss and this module is wrapper of feedparser.

rss.output(schema,callback)

output rss xml. #####Arguments

• schema - your RSS feed's schema.

example

  title: "combiner_rss"
  description: "node_rss_combine"
  feed_url: "http://nikezono.net/rss.xml"
  site_url: "http://nikezono.net"
  image_url: "http://nikezono.net/favicon.ico"
  author: "nikezono"

• callback(xml) - This function gets xml string which combined all added urls.

Articles parameter(quote from feedparser.)

List of meta properties

• title
• description
• link (website link)
• xmlurl (the canonical link to the feed, as specified by the feed)
• date (most recent update)
• pubdate (original published date)
• author
• language
• image (an Object containing url and title properties)
• favicon (a link to the favicon -- only provided by Atom feeds)
• copyright
• generator
• categories (an Array of Strings)

List of article properties

• title
• description (frequently, the full article content)
• summary (frequently, an excerpt of the article content)
• link
• origlink (when FeedBurner or Pheedo puts a special tracking url in the link property, origlink contains the original link)
• date (most recent update)
• pubdate (original published date)
• author
• guid (a unique identifier for the article)
• comments (a link to the article's comments section)
• image (an Object containing url and title properties)
• categories (an Array of Strings)
• source (an Object containing url and title properties pointing to the original source for an article; see the RSS Spec for an explanation of this element)
• enclosures (an Array of Objects, each representing a podcast or other enclosure and having a url property and possibly type and length properties)
• meta (an Object containing all the feed meta properties; especially handy when using the EventEmitter interface to listen to article emissions)