Creating the Feed

Site owners wishing to submit feeds for use in SearchMonkey applications do so through Yahoo! Site Explorer. You can validate your feed using the feed validator tool, which you can download from here: http://tech.groups.yahoo.com/group/searchmonkey-siteowners/files/.

Standard Feed Requirements

The SearchMonkey feed format is based on the Atom Syndication Format 1.0 (RFC 4287). A feed must be a valid instance of this format, as indicated by off-the-shelf feed validator tools. Like conventional feeds, each URL corresponds to one entry in the feed, represented in Atom with an entry element. Each entry must have:

an id for the URL of the page without a fragment identifier, # and subsequent characters

This is a globally unique value based on the combination of a reversed domain name and publishing group within that organization. If in doubt, err on the side of more fine-grained identification.
an updated timestamp
a title

	Note
	The recommended practice is for a single feed-level 'updated' attribute, but if necessary, one 'updated' attribute in every entry is acceptable as well.

Constructing the Feed

To demonstrate the construction of a typical field, suppose socialnetwork.com has a user profile page. The page itself has some properties, such as last update, but primarily describes a person, who has a birthday. This could be represented in the following feed:

<y:adjunct version="1.0"
           name="sampleprof"
           xmlns:y="http://search.yahoo.com/datarss/"
           xmlns:foaf="http://xmlns.com/foaf/0.1/">

  <y:item rel="dc:subject">
    <y:type typeof="foaf:Person">
      <y:meta property="foaf:name">John Doe</y:meta>
      <y:meta property="foaf:birthday">10-05</y:meta>
    </y:type>
  </y:item>
</y:adjunct>

Later, suppose socialnetwork.com adds a new feature where a profile can also contain details about a best friend. These would reside within a separate item element, eliminating confusion between possibly duplicate properties like vcard:bday. For example:

<y:adjunct version="1.0"
           name="sampleprof"
           xmlns:y="http://search.yahoo.com/datarss/"
           xmlns:foaf="http://xmlns.com/foaf/0.1/">

  <y:item rel="dc:subject">
    <y:type typeof="foaf:Person">
      <y:meta property="foaf:name">John Doe</y:meta>
      <y:meta property="foaf:birthday">10-05</y:meta>
      <y:item rel="foaf:knows">
        <y:type typeof="foaf:Person">
            <y:meta property="foaf:name">Jane Doe</y:meta>
            <y:meta property="foaf:birthday">19-03</y:meta>
            <y:item rel="foaf:email" resource="mailto:janedoe@example.org"/>
        </y:type>
      </y:item>
    </y:type>
  </y:item>
</y:adjunct>

If you will be using an unknown namespace, you must declare it, as in the following product listing example:

<y:adjunct version="1.1"
           name="plisting"
           xmlns:y="http://search.yahoo.com/datarss/"
           xmlns:digicam="http://example.com/vocab/digicam">
  <y:item rel="dc:subject">
     <y:type typeof="product:Product digicam:Digicam">
       <y:meta prop="digicam:megapixels">7.2</y:meta>
     </y:type>
  </y:item>
</y:adjunct>

SearchMonkey Guide