zotero-research

Investigación y citas con Zotero

Este flujo conecta con la biblioteca local de Zotero (API local en el puerto 23119). Zotero debe estar abierto con el ajuste "Allow other applications on this computer to communicate with Zotero" habilitado.

1. Buscar referencias

1. Usa zotero_search con palabras clave (query). Si ningún item las contiene todas, devuelve los que contienen alguna con partialMatch: true y matchedWords: revisa por el título que de verdad traten el tema antes de citarlos.
2. Si el usuario menciona una carpeta/colección, consúltala con zotero_list_collections y filtra con collectionKey.
3. Presenta los resultados con: clave, título, autores y año. No inventes datos: usa solo lo que devuelve la herramienta.

Buscar fuera de la biblioteca

Si la biblioteca no tiene lo que el usuario necesita, o pide fuentes nuevas, usa zotero_find_external:

1. query con el tema, título o autores (en el idioma de las publicaciones buscadas; en inglés suele haber más resultados), o doi si ya lo conoces. Filtra con yearFrom/yearTo si pide fuentes recientes, y usa includeAbstract: true para juzgar la relevancia.
2. Presenta título, autores, año, revista y DOI. Señala cuáles tienen acceso abierto (openAccessUrl) y cuáles ya están en la biblioteca (inLibrary.key, con sus colecciones en inLibrary.collections): esas se pueden citar directamente con su key, sin guardarlas otra vez.
3. Las que no están en la biblioteca no se pueden citar todavía: hay que guardarlas antes con zotero_add_item (ver abajo).
4. Si llega un aviso de que OpenAlex no respondió, los resultados son de Crossref; menciónalo solo si importa (p. ej. no hay datos de acceso abierto).

Guardar en la biblioteca

1. Guarda solo lo que el usuario elija: nunca guardes resultados por tu cuenta ni en bloque sin que lo pida.
2. Llama zotero_add_item con doi (o openAlexId si no tiene DOI), y collectionKey (de zotero_list_collections) y tags si el usuario los indica. Sin apply devuelve una vista previa: muéstrale título, autores, año y la colección destino (target).
3. Cuando confirme, repite la llamada con apply: true. La respuesta trae la key del item nuevo: úsala directamente con zotero_cite o zotero_insert_citation_docx.
4. Si responde saved: false porque ya existe (inLibrary.key), usa esa key para citar. Aunque el usuario haya pedido guardarlo en otra colección, no uses allowDuplicate: crearía un segundo item igual en su biblioteca. zotero-mcp no puede añadir un item existente a otra colección; si el usuario lo quiere también ahí, puede arrastrarlo en Zotero. Usa allowDuplicate solo si el usuario pide expresamente un duplicado.
   • Al terminar, dile qué publicaciones no se añadieron a la colección pedida porque ya estaban en la biblioteca, y en qué colecciones están (inLibrary.collections).
5. Requiere Zotero abierto. Sin collectionKey se guarda en la colección seleccionada en Zotero: si el usuario no dijo dónde, pregúntale o díselo en la vista previa.